linux-svn命令

http://www.cnblogs.com/ylqmf/archive/2011/09/13/2174429.html

http://blog.csdn.net/vincent17113/article/details/6265423：未整理参考文章

1，SVN简介

SVN（Subversion）是一个自由、开源的项目源代码版本控制工具。目前，绝大多数开源软件和企业代码管理，都使用SVN作为代码版本管理软件。SVN将文件存放在中心版本库里，这个版本库很像一个普通的文件服务器。不同的是，它可以记录每一次文件和目录的修改情况，这样就可以在需要的回滚时，将数据恢复到以前的版本，并可以查看数据的更改细节。

因为你的工作拷贝“同你系统上的文件和目录没有任何区别”，你可以随意修改文件，但是你必须告诉Subversion你做的其他任何事。例如，你希望拷贝或移动工作拷贝的一个文件，你应该使用svn copy或者 svn move而不要使用操作系统的拷贝移动命令。

.svn目录包含什么？

工作拷贝中的任何一个目录包括一个名为.svn管理区域，通常列表操作不显示这个目录，但它仍然是一个非常重要的目录，无论你做什么？不要删除或是更改这个管理区域的任何东西，Subversion使用它来管理工作拷贝。如果你不小心删除了子目录.svn，最简单的解决办法是删除包含的目录（普通的文件系统删除，而不是svn delete），然后在父目录运行svn update，Subversion客户端会重新下载你删除的目录，并包含新的.svn。 

2，SVN常用命令

2.1、svn co：将文件checkout到本地目录

svn checkout path

简写：svn co path

说明：path是服务器上的目录

例如：svn co svn://192.168.1.1/pro/domain

2.2、svn add：往版本库中添加新的文件

svn add file

说明：不能直接使用 svn add * 命令，必须使用 “svn add * --force” 命令。--force参数只不过是驱使 svn 去检查一个子目录，而不管这个子目录是否已经纳入管理。

例如：svn add *.php(添加当前目录下所有的php文件)

2.3、svn ci：将改动的文件提交到版本库

svn commit -m “LogMessage” [-N] [--no-unlock] PATH(如果选择了保持锁，就使用–no-unlock开关)

简写：svn ci -m ‘’

例如：svn ci -m “add test file for my test“ test.php

2.4、svn lock：加锁/解锁

svn lock -m “LockMessage” [--force] PATH

svn unlock PATH

例如：svn lock -m “lock test file“ test.php

2.5、svn up：更新到某个版本

svn update -r m path

简写：svn up

说明：svn update如果后面没有目录，默认将当前目录以及子目录下的所有文件都更新到最新版本。

例如：svn up -r 200 test.php(将版本库中的文件test.php还原到版本200)

Select: (p) postpone, (df) diff-full, (e) edit,
        (mc) mine-conflict, (tc) theirs-conflict,
        (s) show all options:
svn detects that theres a conflict here and require you to take some kind of action.

(e)  edit             - change merged file in an editor               #直接进入编辑
(df) diff-full        - show all changes made to merged file          #显示更改至目标文件的所有变化
(r)  resolved         - accept merged version of file

(dc) display-conflict - show all conflicts (ignoring merged version)  #显示所有冲突
(mc) mine-conflict    - accept my version for all conflicts (same)    #冲突以本地为准
(tc) theirs-conflict  - accept their version for all conflicts (same) #冲突以服务器为准

(mf) mine-full        - accept my version of entire file (even non-conflicts)#完全以本地为准
(tf) theirs-full      - accept their version of entire file (same)    #完全以服务器为准

(p)  postpone         - mark the conflict to be resolved later        #标记冲突，稍后解决
(l)  launch           - launch external tool to resolve conflict
(s)  show all         - show this list

举例如下：

1，创建test.txt

test

2，上传该文件，版本为revision3

C:\workspace\test>svn ci -m "making a starting point"
Sending        .
Sending        test.txt
Transmitting file data .
Committed revision 2.

3，假设我们有User1和User2. 二者均从repository中update下载该文件，版本为revision2

C:\workspace\test>svn up
A    test.txt
At revision 2.

4，User1修改文件test.txt

User1 is making a conflict test

5，User1上传文件test.txt  版本为revision3

C:\workspace\test>svn ci -m "User1 starting a conflict"
Sending        .
Sending        test.txt
Transmitting file data .
Committed revision 3.

6，User2修改文件test.txt

test User2 making a conflict

7，User2上传文件test.txt，版本为revision4，遇到错误

svn: Commit failed (details follow):
svn: File or directory 'test.txt' is out of date; try updating
svn: resource out of date; try updating

8，User2开始更新文件

C:\workspace\test>svn up
Conflict discovered in 'test.txt'.
Select: (p) postpone, (df) diff-full, (e) edit,
        (mc) mine-conflict, (tc) theirs-conflict,
        (s) show all options:
svn detects that theres a conflict here and require you to take some kind of action.

9，User2选择‘df’，展开冲突的内容

Select: (p) postpone, (df) diff-full, (e) edit,
        (mc) mine-conflict, (tc) theirs-conflict,
        (s) show all options: df
--- .svn/text-base/test.txt.svn-base    Tue Aug 10 10:59:38 2010
+++ .svn/tmp/test.txt.2.tmp     Tue Aug 10 11:33:24 2010
@@ -1 +1,3 @@
-test
\ No newline at end of file
+<<<<<<< .mine +test User2 making conflict======= +User1 is making a conflict test>>>>>>> .r3

10，User2选择‘e’，可编辑冲突的内容

<<<<<<< .mine test User2 making conflict======= User1 is making a conflict test>>>>>>> .r3

11，User2按如下方式编辑了冲突并保存：

User1 is making a conflict test User2 making conflict

12，User2重新选择‘r’，表示resolved并被标记为G（表示该文件冲突已被解决）

Select: (p) postpone, (df) diff-full, (e) edit, (r) resolved,
        (mc) mine-conflict, (tc) theirs-conflict,
        (s) show all options: e
Select: (p) postpone, (df) diff-full, (e) edit, (r) resolved,
        (mc) mine-conflict, (tc) theirs-conflict,
        (s) show all options: r
G    test.txt
Updated to revision 3.

13，User2检查该文件状态

C:\workspace\test2>svn st
M       test.txt

14，User2提交该文件，版本为revision4

C:\workspace\test2>svn ci -m "conflict resolved"
Sending        test.txt
Transmitting file data .
Committed revision 4.

15，User2刚才也可以选择‘p’来延迟解决冲突

Select: (p) postpone, (df) diff-full, (e) edit, (r) resolved,
        (mc) mine-conflict, (tc) theirs-conflict,
        (s) show all options: p
C    test.txt
Updated to revision 3.
Summary of conflicts:
  Text conflicts: 1

16，这时会发现svn帮助建立了如下三个文件

08/10/2010  11:44 AM                94 test.txt
08/10/2010  11:44 AM                26 test.txt.mine
08/10/2010  11:44 AM                27 test.txt.r2
08/10/2010  11:44 AM                31 test.txt.r3
test.txt为包含User1与User2冲突的文件
<<<<<<< .mine test User2 making conflict======= User1 am making a conflict test>>>>>>> .r3

test.txt.mine是User2的本地文件

test User2 making conflict

test.txt.r2为原始reversion2的拷贝

test

test.txt.r3为User1提交的reversion3的拷贝

User1 is making a conflict test

17，此时User2修改了test.txt的冲突并提交

C:\workspace\test>svn resolve --accept working test.txt
Resolved conflicted state of 'test.txt'
C:\workspace\test>svn ci -m "conflict resolved"
Sending        test.txt
Transmitting file data .
Committed revision 4.

2.6、svn st：查看文件或者目录状态

1）svn status path（目录下的文件和子目录的状态，正常状态不显示）

说明：【?：不在svn的控制中；M：内容被修改；C：发生冲突；A：预定加入到版本库；K：被锁定】

2）svn status -v path(显示文件和子目录状态)

说明：【第一列保持相同，第二列显示工作版本号，第三和第四列显示最后一次修改的版本号和修改人。】

简写：svn st 

注：svn status、svn diff和 svn revert这三条命令在没有网络的情况下也可以执行的，原因是svn在本地的.svn中保留了本地版本的原始拷贝。

例如： svn st -q (只显示本地修改条目信息)

svn status可能返回的状态码
A 
文件、目录或是符号链item预定加入到版本库。
C 
文件item发生冲突，在从服务器更新时与本地版本发生交迭，在你提交到版本库前，必须手工的解决冲突。
D 
文件、目录或是符号链item预定从版本库中删除。
M 
文件item的内容被修改了。
R 
文件、目录或是符号链item预定将要替换版本库中的item，这意味着这个对象首先要被删除，另外一个同名的对象将要被添加，所有的操作发生在一个修订版本。
X 
目录没有版本化，但是与Subversion的外部定义关联，关于外部定义，可以看“外部定义”一节。
? 
文件、目录或是符号链item不在版本控制之下，你可以通过使用svn status的--quiet（-q）参数或父目录的svn:ignore属性忽略这个问题。
! 
文件、目录或是符号链item在版本控制之下，但是已经丢失或者不完整，这可能因为使用非Subversion命令删除造成的，如果是一个目录，有可能是检出或是更新时的中断造成的，使用svn update可以重新从版本库获得文件或者目录，也可以使用svn revert file恢复原来的文件。
~ 
文件、目录或是符号链item在版本库已经存在，但你的工作拷贝中的是另一个。举一个例子，你删除了一个版本库的文件，新建了一个在原来的位置，而且整个过程中没有使用svn delete或是svn add。
I 
文件、目录或是符号链item不在版本控制下，Subversion已经配置好了会在svn add、svn import和svn status命令忽略这个文件。注意，这个符号只会在使用svn status的参数--no-ignore时才会出现—否则这个文件会被忽略且不会显示！

2.7、svn del：删除文件

svn delete path -m “delete test fle”

简写：svn (del, remove, rm)

例如：先，svn delete test.php     再，svn ci -m ‘delete test file‘

2.8、svn log：查看日志

svn log path

例如：svn log  -l 3 test.php 显示这个文件的最近三条修改记录，及其版本号的变化

例如：svn log file -r 204424显示 r204424这个版本的提交信息

例如：svn log file -r 204424 -v 详细显示 r204424这个版本的提交记录

2.9、svn info：查看文件详细信息

svn info path

例如： svn info test.php

2.10、svn diff：比较差异

1）svn diff path(将修改的文件与基础版本比较)

例如：svn diff test.php

2）svn diff -r m:n path(对版本m和版本n比较差异)

例如：svn diff -r 200:201 test.php

例如：svn diff -c r208425 查看这个版本的差别

简写：svn di  

root@letuknowit:/home/kris/calc/trunk# svn diff main.c
Index: main.c
===================================================================
--- main.c      (revision 8)
+++ main.c      (working copy)
@@ -7,7 +7,8 @@
        printf("5 + 10 = %d.\n",add(5,10));
        printf("15 - 10 = %d.\n",sub(15,10));
        //kris's test
-       printf("kris: 12 + 28 = %d.\n",add(12,28));
+       printf("kris: 32 + 28 = %d.\n",add(32,28));
+       printf("kris: 15 - 10 = %d.\n",sub(15,10));
        //sally's test
        printf("sally: 60 - 33 = %d.\n",sub(60,33));
        return 0;

svn diff可以查看当前工作拷贝中所有的被修改的文件，对于每个文件的diff输出部分由Index: 文件名的形式进行区分。等于号后面的内容就是关于main.c文件的diff情况了。

--- main.c      (revision 8)
+++ main.c      (working copy)

--- 打头的是原始文件，也就是版本库中的最新版本，或者理解为修改前的文件
+++ 打头的是目标文件，这个就是你修改后的版本

@@ -7,7 +7,8 @@

这里的-和+分别表示原始文件和目标文件，7,7表示从第7行开始的7行，-7,7就是原始文件的从第7行开始的7行内容，+7,8的意思类似，表示目标文件从第7行开始的8行内容。

结合起来理解就是：目标文件从第7行开始的8行内容和原始文件的从第7行开始的7行内容之间存在差异

        printf("5 + 10 = %d.\n",add(5,10));
        printf("15 - 10 = %d.\n",sub(15,10));
        //kris's test
-       printf("kris: 12 + 28 = %d.\n",add(12,28));
+       printf("kris: 32 + 28 = %d.\n",add(32,28));
+       printf("kris: 15 - 10 = %d.\n",sub(15,10));
        //sally's test
        printf("sally: 60 - 33 = %d.\n",sub(60,33));
        return 0;

这个就是具体的差异情况了，前面的-号表示需要从原始文件中删除的行，+号表示目标文件中将要增加的行，-号开头的部分只属于原始文件，+号开头的部分只属于目标文件，其余的是两者相同的部分。

  7   1   1         printf("5 + 10 = %d.\n",add(5,10));
  8   2   2         printf("15 - 10 = %d.\n",sub(15,10));
  9   3   3         //kris's test
 10   4     -       printf("kris: 12 + 28 = %d.\n",add(12,28));
 11       4 +       printf("kris: 32 + 28 = %d.\n",add(32,28));
 12       5 +       printf("kris: 15 - 10 = %d.\n",sub(15,10));
 13   5   6         //sally's test
 14   6   7         printf("sally: 60 - 33 = %d.\n",sub(60,33));
 15   7   8         return 0;

为了进一步了解@@ -7,7 +7,8 @@的意思，上面加上了行号等信息，第一列的数字是行号，后面两列的数字表示第几行。经过标注可以清晰的看出原始文件第7行开始的7行和目标文件第7行开始的8行内容了。

2.11、svn merge：将两个版本之间的差异合并到当前文件

svn merge -r m:n path

例如：svn merge -r 200:205 test.php（将版本200与205之间的差异合并到当前文件，但是一般都会产生冲突，需要处理一下）

2.12、svn  help：帮助

svn help

svn help ci

2.13、svn mkdir：创建新目录

svn mkdir

说明：创建纳入版本控制下的新目录。

2.14、svn revert：恢复本地修改

svn revert PATH

说明： 主要用来恢复文件的SVN状态，比如一个SVN下文件是A(add)，D(delete)，M(modify)状态，那么用svn revert可以恢复该文件到原来的“SVN状态”。

2.15、svn resolved：解决冲突

svn resolved PATH

说明：移除工作副本的目录或文件的“冲突”状态。
注意: 本子命令不会依语法来解决冲突或是移除冲突标记；它只是移除冲突的相关文件，然后让 PATH 可以再次提交。

2.16、svn import：导入

使用svn import是把未版本化的文件树复制到资料库的快速办法，它需要创建一个临时目录。 

$ svnadmin create /usr/local/svn/newrepos
$ svn import mytree file:///usr/local/svn/newrepos/some/project
Adding         mytree/foo.c
Adding         mytree/bar.c
Adding         mytree/subdir
Adding         mytree/subdir/quux.h


Committed revision 1.

上面的例子把在some/project目录下mytree目录的内容复制到资料库中。 

$ svn list file:///usr/local/svn/newrepos/some/project
bar.c
foo.c
subdir/

注意在导入完成后，原来的树没有被转化成一个工作副本。为了开始工作，你仍然需要svn checkout这个树的一个新的工作副本。

2.17 svn diff --summarize：分支diff打包

在某个分支上，都是自己的代码，需要最终合线，可以只将之前的diff找出来打包

svn diff --summarize -r37565:37571 | awk '{print $2}' | xargs tar czvf 	backup_$(date +%F).tar.gz

tar -czvf test_diff.tar.gz `svn di --summarize -r41413:41408| awk '{print $2}' `  

注意，在查找原来版本和最新版本时，svn log 默认是当前目录的log记录。不一定是整个代码树的最新log。所以建议使用URL来查找。

svn log https://develop/genericbranch_7 | less

2.18 创建一个新的分支

svn cp -m "create new branch" http://online -r 38577 http://branch_7

3，svn一般查日志流程

更新代码：svn up   

查看日志：svn log 
查看具体修改信息：svn diff -c r208425
svn恢复具体版本：svn revert -r 208425

4，典型的工作周期是这样的：

更新你的工作拷贝
svn update
做出修改
svn add
svn delete
svn copy
svn move
检验修改
svn status
svn diff
可能会取消一些修改
svn revert
解决冲突（合并别人的修改）
svn update
svn resolved
提交你的修改
svn commit

5，SVN 常用命令一览表

命令	功能	使用格式
checkout	检出	svn  co  URL
up	更新到当前URL的末端	svn  up
switch	更新到某一tag/branch	svn  switch  (tag/分支)URL
add	增加	svn  add  文件名/目录名
rm	删除文件	svn  rm 文件名
	删除目录	svn  rm 目录名
diff	与base版本（最后检出或者更新到的版本）对比	svn  diff
	与版本库中最新版本对比	svn  diff  -r  head
	当前工作副本，两个版本之间对比	svn  diff  -r  reversion1:reversion2
	版本库中任意两个tag做对比	svn   diff    (tag1)URL    (tag2)URL
ci	提交	svn ci -m "commit log"
log	查看当前工作副本log	svn  log
	只查看指定版本的log	svn  log  -r
	打印log所有附加信息	svn  log  -v
	查看当前tag/branch版本详情	svn  log --stop-on-copy -v
info	查看当前工作副本所在URL	svn  info
status	查看工作副本的状态	svn st
	查看文件的taglist	svn命令不支持，可执行cs taglist
tag	新增tag	svn cp . （tag）URL
	删除tag	svn rm （tag）URL -m "commit log"
	覆盖已经存在的tag	不支持
分支开发	创建branch	svn  cp  （基线版本）URL （分支）URL  -m "commit log"
	删除branch	svn rm （分支）URL   -m "commit log"
	同步	svn co （主干）URL
		cd ~/wc
		svn merge （主干）URL （待同步tag）URL
		svn ci -m "commit log"
		svn cp （主干）URL （以_PD_BL_MAIN结尾的tag）URL -m"commit log"
	合并	svn co （合并目标）URL
		cd ~/wc
		svn merge （基线版本tag）URL  （上线tag）URL
		svn ci -m "commit log"
		svn cp （合并目标）URL （上线tag_MERGE_的tag对应）URL -m"commit log"