svn 常用命令集合

SVN的全称是Subversion，即版本控制系统。它是最流行的一个开放源代码的版本控制系统。作为一个开源的版本控制系统，Subversion管理着随时间改变的数据。这些数据放置在一个中央资料档案库（Repository）中。这个档案库很像一个普通的文件服务器，不过它会记住每一次文件的变动。这样就可以把档案恢复到旧的版本，或是浏览文件的变动历史。Subversion是一个通用的系统，可用来管理任何类型的文件，其中包括程序源码。

SVN采用客户端/服务器体系，项目的各种版本都存储在服务器上，程序开发人员首先将从服务器上获得一份项目的最新版本，并将其复制到本机，然后在此基础上，每个开发人员可以在自己的客户端进行独立的开发工作，并且可以随时将新代码提交给服务器。当然也可以通过更新操作获取服务器上的最新代码，从而保持与其他开发者所使用版本的一致性。

SVN的客户端有两类，一类是基于Web的WebSVN等，另一类是以Tortoise SVN为代表的客户端软件。前者需要Web服务器的支持，后者需要用户在本地安装客户端，两种都有免费的开源软件供使用。SVN存储版本数据也两种方式：BDB（一种事务安全型表类型）和FSFS（一种不需要数据库的存储系统）。因为BDB方式在服务器中断时，有可能锁住数据，所以还是FSFS方式更安全一点。

svn基本的操作流程就是：

　　你刚刚进入一个新的公司，让你接手一个正在进行的项目，你打开终端写下了：

svn co svn://192.168.1.1/pro/domain

然后就可以在当前目录里面找到一个叫domain的项目，cd domain，你浏览了几行代码，太特么的竟然有bug，你忍不住改了，你要提交了

svn ci -m 'something'

成功。你又在domain下得app文件夹下添加了几个.php文件，把整个项目都做完了！你又打开终端：

svn add domain/app/*.php

添加成功。太牛逼了，下班了，你去吃了一碗自己最喜欢的老坛酸菜味方便面。

以下是一些常用命令

1、将文件checkout到本地目录

svn checkout path（path是服务器上的目录）
例如：svn checkout svn://192.168.1.1/pro/domain
简写：svn co

2、往版本库中添加新的文件

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

3、将改动的文件提交到版本库

svn commit -m “LogMessage“ [-N] [--no-unlock] PATH(如果选择了保持锁，就使用–no-unlock开关)
例如：svn commit -m “add test file for my test“ test.php
简写：svn ci

4、加锁/解锁

svn lock -m “LockMessage“ [--force] PATH
例如：svn lock -m “lock test file“ test.php
svn unlock PATH

5、更新到某个版本

svn update -r m path
例如：
svn update如果后面没有目录，默认将当前目录以及子目录下的所有文件都更新到最新版本。
svn update -r 200 test.php(将版本库中的文件test.php还原到版本200)
svn update test.php(更新，于版本库同步。如果在提交的时候提示过期的话，是因为冲突，需要先update，修改文件，然后清除svn resolved，最后再提交commit)

简写：svn up

6、查看文件或者目录状态

svn status path（目录下的文件和子目录的状态，正常状态不显示）
【?：不在svn的控制中；M：内容被修改；C：发生冲突；A：预定加入到版本库；K：被锁定】
svn status -v path(显示文件和子目录状态)
 第一列保持相同，第二列显示工作版本号，第三和第四列显示最后一次修改的版本号和修改人。
 注：svn status、svn diff和 svn revert这三条命令在没有网络的情况下也可以执行的，原因是svn在本地的.svn中保留了本地版本的原始拷贝。
 简写：svn st

7、删除文件

svn delete path -m “delete test fle“
例如：svn delete svn://192.168.1.1/pro/domain/test.php -m “delete test file”
或者直接svn delete test.php 然后再svn ci -m ‘delete test file‘，推荐使用这种
简写：svn (del, remove, rm)

8、查看日志

svn log path
例如：svn log test.php 显示这个文件的所有修改记录，及其版本号的变化

9、查看文件详细信息

svn info path
例如：svn info test.php

10、比较差异

svn diff path(将修改的文件与基础版本比较)
例如：svn diff test.php
svn diff -r m:n path(对版本m和版本n比较差异)
例如：svn diff -r 200:20test.php
简写：svn di 

11、将两个版本之间的差异合并到当前文件

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

12、SVN 帮助

svn help
svn help ci

13、版本库下的文件和目录列表

svn list path
显示path目录下的所有属于版本库的文件和目录
简写：svn ls

14、创建纳入版本控制下的新目录

svn mkdir: 创建纳入版本控制下的新目录。
用法:
1、mkdir PATH…
2、mkdir URL…
创建版本控制的目录。
1、每一个以工作副本 PATH 指定的目录，都会创建在本地端，并且加入新增
调度，以待下一次的提交。
2、每个以URL指定的目录，都会透过立即提交于仓库中创建。
在这两个情况下，所有的中间目录都必须事先存在

15、恢复本地修改

svn revert: 恢复原始未改变的工作副本文件 (恢复大部份的本地修改)。revert:
用法: revert PATH…
注意: 本子命令不会存取网络，并且会解除冲突的状况。但是它不会恢复
被删除的目录 

16、代码库URL变更

 svn switch (sw): 更新工作副本至不同的URL。
 用法: 1、switch URL [PATH]
 2、switch –relocate FROM TO [PATH...]
 
 1、更新你的工作副本，映射到一个新的URL，其行为跟“svn update”很像，也会将
 服务器上文件与本地文件合并。这是将工作副本对应到同一仓库中某个分支或者标记的
 方法。
 2、改写工作副本的URL元数据，以反映单纯的URL上的改变。当仓库的根URL变动
 (比如方案名或是主机名称变动)，但是工作副本仍旧对映到同一仓库的同一目录时使用
 这个命令更新工作副本与仓库的对应关系。 

17、解决冲突

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

查看修改的文件记录

svn cat -- 显示特定版本的某文件内容。
svn list -- 显示一个目录或某一版本存在的文件列表。
svn log -- 显示svn 的版本log，含作者、日期、路径等。
svn diff -- 显示特定修改的行级详细信息。

list示例：

svn list http://svn.test.com/svn     #查看目录中的文件。
svn list -v http://svn.test.com/svn  #查看详细的目录的信息(修订人,版本号,文件大小等)。
svn list [-v]                        #查看当前当前工作拷贝的版本库URL。

cat示例：

svn cat -r 4 test.c     #查看版本4中的文件test.c的内容,不进行比较。

diff示例：

svn diff               #什么都不加，会坚持本地代码和缓存在本地.svn目录下的信息的不同;信息太多，没啥用处。
svn diff -r 3          #比较你的本地代码和版本号为3的所有文件的不同。
svn diff -r 3 text.c   #比较你的本地代码和版本号为3的text.c文件的不同。
svn diff -r 5:6        #比较版本5和版本6之间所有文件的不同。
svn diff -r 5:6 text.c #比较版本5和版本6之间的text.c文件的变化。
svn diff -c 6 test.c    #比较版本5和版本6之间的text.c文件的变化。

log示例：

svn log         #什么都不加会显示所有版本commit的日志信息:版本、作者、日期、comment。
svn log -r 4:20 #只看版本4到版本20的日志信息，顺序显示。
svn log -r 20:5 #显示版本20到4之间的日志信息，逆序显示。
svn log test.c  #查看文件test.c的日志修改信息。
svn log -r 8 -v #显示版本8的详细修改日志，包括修改的所有文件列表信息。
svn log -r 8 -v -q   #显示版本8的详细提交日志，不包括comment。
svn log -v -r 88:866 #显示从版本88到版本866之间，当前代码目录下所有变更的详细信息 。
svn log -v dir  #查看目录的日志修改信息,需要加v。
svn log http://foo.com/svn/trunk/code/  #显示代码目录的日志信息。

常用命令

svn add file|dir -- 添加文件或整个目录
svn checkout -- 获取svn代码
svn commit  -- 提交本地修改代码
svn status    -- 查看本地修改代码情况：修改的或本地独有的文件详细信息
svn merge   -- 合并svn和本地代码
svn revert   -- 撤销本地修改代码
svn resolve -- 合并冲突代码
svn help [command] -- 查看svn帮助，或特定命令帮助

svn diff个性化定制

svn配置文件: ~/.subversion/config

修改~/.subversion/config，找到如下配置行：

# diff-cmd = diff_program (diff, gdiff, etc.)
将上面那个脚本的路径添加进去就行，修改为

diff-cmd = /usr/local/bin/diffwrap.sh  #绝对路径
这样svn diff命令就会默认使用vimdiff比较文件。

diffwrap.sh文件

#! /bin/bash
 
# for svn diff: 修改~/.subversion/config，找到如下配置行：
# diff-cmd = diff_program (diff, gdiff, etc.)
# diff-cmd = ~/bin/diffwrap.sh
 
# 参数大于5时，去掉前5个参数；参数小于5，失败，什么也不做
shift 5
 
# 使用vimdiff比较
vimdiff "$@"

参考文献

使用vimdiff作为svn diff的查看代码工具：https://www.jb51.net/LINUXjishu/734861.html

SVN常用命令: http://blog.csdn.net/sunboy_2050/article/details/6187464

svn 常用操作命令

检出

svn checkout http://路径(目录或文件的全路径)　[本地目录全路径] --username　用户名
svn checkout svn://路径(目录或文件的全路径)　[本地目录全路径] --username　用户名
 
# 例子：
svn co svn://localhost/测试工具 /home/testtools --username wzhnsc
svn co http://localhost/test/testapp --username wzhnsc
svn checkout svn://localhost/测试工具 /home/testtools --username wzhnsc
svn checkouthttp://localhost/test/testapp --username wzhnsc

注：如果不带--password 参数传输密码的话，会提示输入密码，建议不要用明文的--password 选项。
　　 其中 username 与 password前是两个短线，不是一个。
　　 不指定本地目录全路径，则检出到当前目录下。

导出(导出一个干净的不带.svn文件夹的目录树)

svn export [-r 版本号] http://路径(目录或文件的全路径) [本地目录全路径]　--username　用户名
svn export [-r 版本号] svn://路径(目录或文件的全路径) [本地目录全路径]　--username　用户名
svn export 本地检出的(即带有.svn文件夹的)目录全路径 要导出的本地目录全路径
 
例子：
svn export svn://localhost/测试工具 /home/testtools --username wzhnsc
svn export svn://localhost/test/testapp --username wzhnsc
svn export /home/testapp /home/testtools

注：第一种从版本库导出干净工作目录树的形式是指定URL，
如果指定了修订版本号，会导出相应的版本，
如果没有指定修订版本，则会导出最新的，导出到指定位置。
如果省略 本地目录全路径，URL的最后一部分会作为本地目录的名字。
第二种形式是指定 本地检出的目录全路径 到 要导出的本地目录全路径，所有的本地修改将会保留，
但是不在版本控制下(即没提交的新文件，因为.svn文件夹里没有与之相关的信息记录)的文件不会拷贝。

添加新文件

svn　add　文件名
注：告诉SVN服务器要添加文件了，还要用svn commint -m真实的上传上去！
例子：
svn add test.php ＜－ 添加test.php 
svn commit -m “添加我的测试用test.php“ test.php
svn add *.php ＜－ 添加当前目录下所有的php文件
svn commit -m “添加我的测试用全部php文件“ *.php

提交

svn　commit　-m　“提交备注信息文本“　[-N]　[--no-unlock]　文件名
svn　ci　-m　“提交备注信息文本“　[-N]　[--no-unlock]　文件名
必须带上-m参数，参数可以为空，但是必须写上-m
例子：
svn commit -m “提交当前目录下的全部在版本控制下的文件“ * ＜－ 注意这个*表示全部文件
svn commit -m “提交我的测试用test.php“ test.php
svn commit -m “提交我的测试用test.php“ -N --no-unlock test.php ＜－ 保持锁就用–no-unlock开关
svn ci -m “提交当前目录下的全部在版本控制下的文件“ * ＜－ 注意这个*表示全部文件
svn ci -m “提交我的测试用test.php“ test.php
svn ci -m “提交我的测试用test.php“ -N --no-unlock test.php ＜－ 保持锁就用–no-unlock开关

更新文件

svn　update
svn　update　-r　修正版本　文件名
svn　update　文件名
例子：
svn update ＜－ 后面没有目录，默认将当前目录以及子目录下的所有文件都更新到最新版本
svn update -r 200 test.cpp ＜－ 将版本库中的文件 test.cpp 还原到修正版本（revision）200
svn update test.php ＜－ 更新与版本库同步。
　　　　　　　　　　　 提交的时候提示过期冲突，需要先 update 修改文件，
　　　　　　　　　　　 然后清除svn resolved，最后再提交commit。

删除文件

svn　delete　svn://路径(目录或文件的全路径) -m “删除备注信息文本”
推荐如下操作：
svn　delete　文件名 
svn　ci　-m　“删除备注信息文本”
例子：
svn delete svn://localhost/testapp/test.php -m “删除测试文件test.php”
推荐如下操作：
svn delete test.php 
svn ci -m “删除测试文件test.php”

加锁/解锁

svn　lock　-m　“加锁备注信息文本“　[--force]　文件名 
svn　unlock　文件名
例子：
svn lock -m “锁信测试用test.php文件“ test.php 
svn unlock test.php

比较差异

svn　diff　文件名 
svn　diff　-r　修正版本号m:修正版本号n　文件名
例子：
svn diff test.php＜－ 将修改的文件与基础版本比较
svn diff -r 200:201 test.php＜－ 对 修正版本号200 和 修正版本号201 比较差异

查看文件或者目录状态

svn st 目录路径/名
svn status 目录路径/名＜－ 目录下的文件和子目录的状态，正常状态不显示 
　　　　　　　　　　　　　【?：不在svn的控制中； M：内容被修改；C：发生冲突；
　　　　　　　　　　　　　　A：预定加入到版本库；K：被锁定】 
svn -v 目录路径/名
svn status -v 目录路径/名＜－ 显示文件和子目录状态
　　　　　　　　　　　　　　【第一列保持相同，第二列显示工作版本号，
　　　　　　　　　　　　　　 第三和第四列显示最后一次修改的版本号和修改人】 

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

查看日志

svn　log　文件名
例子：
svn log test.php＜－ 显示这个文件的所有修改记录，及其版本号的变化 

查看文件详细信息

svn　info　文件名
例子：
svn info test.php

SVN 帮助

svn　help ＜－ 全部功能选项
svn　help　ci ＜－ 具体功能的说明

查看版本库下的文件和目录列表

svn　list　svn://路径(目录或文件的全路径)
svn　ls　svn://路径(目录或文件的全路径)
例子：
svn list svn://localhost/test
svn ls svn://localhost/test ＜－ 显示svn://localhost/test目录下的所有属于版本库的文件和目录 

创建纳入版本控制下的新目录

svn　mkdir　目录名
svn　mkdir　-m　"新增目录备注文本"　http://目录全路径
例子：
svn mkdir newdir
svn mkdir -m "Making a new dir." svn://localhost/test/newdir 

注：添加完子目录后，一定要回到根目录更新一下，不然在该目录下提交文件会提示“提交失败”

svn update

注：如果手工在checkout出来的目录里创建了一个新文件夹newsubdir，
　　再用svn mkdir newsubdir命令后，SVN会提示：
　　svn: 尝试用 “svn add”或 “svn add --non-recursive”代替？
　　svn: 无法创建目录“hello”: 文件已经存在
　　此时，用如下命令解决：
　　svn add --non-recursive newsubdir
　　在进入这个newsubdir文件夹，用ls -a查看它下面的全部目录与文件，会发现多了：.svn目录
　　再用 svn mkdir -m "添hello功能模块文件" svn://localhost/test/newdir/newsubdir 命令，
　　SVN提示：
　　svn: File already exists: filesystem '/data/svnroot/test/db', transaction '4541-1',
　　path '/newdir/newsubdir '

恢复本地修改

svn　revert　[--recursive]　文件名
注意: 本子命令不会存取网络，并且会解除冲突的状况。但是它不会恢复被删除的目录。
例子：
svn revert foo.c ＜－ 丢弃对一个文件的修改
svn revert --recursive . ＜－恢复一整个目录的文件，. 为当前目录 

把工作拷贝更新到别的URL

svn　switch　http://目录全路径　本地目录全路径
例子：
svn switch http://localhost/test/456 . ＜－ (原为123的分支)当前所在目录分支到localhost/test/456

解决冲突

svn　resolved　[本地目录全路径]
例子：
$ svn update
C foo.c
Updated to revision 31.
如果你在更新时得到冲突，你的工作拷贝会产生三个新的文件：
$ ls
foo.c
foo.c.mine
foo.c.r30
foo.c.r31
当你解决了foo.c的冲突，并且准备提交，运行svn resolved让你的工作拷贝知道你已经完成了所有事情。
你可以仅仅删除冲突的文件并且提交，但是svn resolved除了删除冲突文件，还修正了一些记录在工作拷贝管理区域的记录数据，所以我们推荐你使用这个命令。

不checkout而查看输出特定文件或URL的内容

svn　cat　http://文件全路径
例子：
svn cat http://localhost/test/readme.txt
19、新建一个分支copy
svn copy branchA branchB -m "make B branch" // 从branchA拷贝出一个新分支branchB
20、合并内容到分支merge
svn merge branchA branchB // 把对branchA的修改合并到分支branchB

1、将文件checkout到本地目录
 
  svn checkout path（path是服务器上的目录）
   例如：svn checkout svn://192.168.1.1/pro/domain
   简写：svn co

2、往版本库中添加新的文件
 
  svn add file
  例如：svn add test.php(添加test.php)
  svn add *.php(添加当前目录下所有的php文件)

3、将改动的文件提交到版本库
 
  svn commit -m "LogMessage" [-N] [--no-unlock] PATH(如果选择了保持锁，就使用--no-unlock开关)
   例如：svn commit -m "add test file for my test" test.php

   简写：svn ci

4、加锁/解锁
 
  svn lock -m "LockMessage" [--force] PATH
  例如：svn lock -m "lock test file" test.php
  svn unlock PATH

5、更新到某个版本
 
  svn update -r m path
   例如：
   svn update如果后面没有目录，默认将当前目录以及子目录下的所有文件都更新到最新版本。
   svn update -r 200 test.php(将版本库中的文件test.php还原到版本200)
   svn update test.php(更新，于版本库同步。如果在提交的时候提示过期的话，是因为冲突，需要先update，修改文件，然后清除svn resolved，最后再提交commit)

   简写：svn up

6、查看文件或者目录状态
 
  1）svn status path（目录下的文件和子目录的状态，正常状态不显示）
   【?：不在svn的控制中；M：内容被修改；C：发生冲突；A：预定加入到版本库；K：被锁定】
  2）svn status -v path(显示文件和子目录状态)
   第一列保持相同，第二列显示工作版本号，第三和第四列显示最后一次修改的版本号和修改人。
   注：svn status、svn diff和 svn revert这三条命令在没有网络的情况下也可以执行的，原因是svn在本地的.svn中保留了本地版本的原始拷贝。
   简写：svn st
 
7、删除文件
 
  svn delete path -m "delete test fle"
  例如：svn delete svn://192.168.1.1/pro/domain/test.php -m "delete test file"
  或者直接svn delete test.php 然后再svn ci -m 'delete test file‘，推荐使用这种
  简写：svn (del, remove, rm)
 
8、查看日志
 
  svn log path
  例如：svn log test.php 显示这个文件的所有修改记录，及其版本号的变化

9、查看文件详细信息
 
  svn info path
  例如：svn info test.php
10、比较差异
 
  svn diff path(将修改的文件与基础版本比较)
  例如：svn diff test.php
       svn diff -r m:n path(对版本m和版本n比较差异)
  例如：svn diff -r 200:201 test.php
  简写：svn di

11、将两个版本之间的差异合并到当前文件
 
  svn merge -r m:n path
  例如：svn merge -r 200:205 test.php（将版本200与205之间的差异合并到当前文件，但是一般都会产生冲突，需要处理一下）
   
12、SVN 帮助
 
  svn help
  svn help ci

以上是常用命令，下面写几个不经常用的
 
13、版本库下的文件和目录列表
 
  svn list path
  显示path目录下的所有属于版本库的文件和目录

  简写：svn ls

14、创建纳入版本控制下的新目录
 
  svn mkdir: 创建纳入版本控制下的新目录。
  用法: 1、mkdir PATH...
       2、mkdir URL...
 
15、恢复本地修改
 
   svn revert: 恢复原始未改变的工作副本文件 (恢复大部份的本地修改)。revert:
   用法: revert PATH...
   注意: 本子命令不会存取网络，并且会解除冲突的状况。但是它不会恢复
        被删除的目录
 
16、代码库URL变更
 
    svn switch (sw): 更新工作副本至不同的URL。
    用法: 1、switch URL [PATH]
          2、switch --relocate FROM TO [PATH...]
 
          1、更新你的工作副本，映射到一个新的URL，其行为跟“svn update”很像，也会将
             服务器上文件与本地文件合并。这是将工作副本对应到同一仓库中某个分支或者标记的
             方法。
          2、改写工作副本的URL元数据，以反映单纯的URL上的改变。当仓库的根URL变动
             (比如方案名或是主机名称变动)，但是工作副本仍旧对映到同一仓库的同一目录时使用
             这个命令更新工作副本与仓库的对应关系。
 
17、解决冲突
 
   svn resolved: 移除工作副本的目录或文件的“冲突”状态。
   用法: resolved PATH...
   注意: 本子命令不会依语法来解决冲突或是移除冲突标记；它只是移除冲突的
   相关文件，然后让 PATH 可以再次提交。
 
18、输出指定文件或URL的内容。
 
  svn cat 目标[@版本]...如果指定了版本，将从指定的版本开始查找。
  svn cat -r PREV filename > filename (PREV 是上一版本,也可以写具体版本号,这样输出结果是可以提交的)