SVN 常用命令详细解读

一、命令的使用

1. 检出

   svn co http://路径(目录或文件的全路径)　[本地目录全路径] --username 用户名 --password 密码  
   svn co svn://路径(目录或文件的全路径)　[本地目录全路径]  --username 用户名 --password 密码  
   svn checkout http://路径(目录或文件的全路径)　[本地目录全路径] --username　用户名 --password 密码  
   svn checkout svn://路径(目录或文件的全路径)　[本地目录全路径] --username　用户名 --password 密码  
   

   P.S

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

   示例：

   svn co http://localhost/test/testapp --username rambo
   svn co svn://localhost/测试工具 /home/testtools --username rambo
   svn checkout http://localhost/test/testapp --username rambo
   svn checkout svn://localhost/测试工具/home/testtools --username rambo
   

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

   svn export  [-r 版本号] http://路径(目录或文件的全路径) [本地目录全路径]　--username　用户名
   svn export  [-r 版本号] svn://路径(目录或文件的全路径) [本地目录全路径]　--username　用户名
   svn export 本地检出的(即带有 .svn 文件夹的)目录全路径 要导出的本地目录全路径
   

   P.S

   • 第一种从版本库导出干净工作目录树的形式是指定 URL

     • 如果指定了修订版本号，会导出相应的版本
     • 如果没有指定修订版本，则会导出最新的，导出到指定位置
     • 如果省略本地目录全路径，URL 的最后一部分会作为本地目录的名字

   • 第二种形式是指定[本地检出的目录全路径]到要导出的本地目录全路径，所有的本地修改将会保留，但是不在版本控制下(即没提交的新文件，因为 .svn 文件夹里没有与之相关的信息记录)的文件不会拷贝

   示例：

   svn export svn://localhost/测试工具/home/testtools --username rambo
   svn export svn://localhost/test/testapp --username rambo
   svn export /home/testapp/home/testtools
   

3. 添加新文件

   svn　add　文件名
   

   P.S

   告诉 SVN 服务器要添加文件了，还要用 svn commint -m 真实的上传上去

   示例：

   # 添加并提交 test.php
   svn add test.php 
   svn commit -m "添加我的测试用test.php" test.php
   
   # 添加并提交当前目录下所有的 php 文件
   svn add *.php
   svn commit -m "添加我的测试用全部php文件" *.php
   

4. 提交

   svn commit -m "提交备注信息文本" [-N] [--no-unlock] 文件名
   svn ci -m "提交备注信息文本" [-N] [--no-unlock] 文件名
   

   P.S

   必须带上 -m 参数，参数可以为空，但是必须写上 -m

   示例：

   # 注意这个 * 表示全部文件
   svn commit -m "提交当前目录下的全部在版本控制下的文件" *
   
   # 提交test.php
   svn commit -m "提交我的测试用test.php" test.php
   
   # 保持锁就用 –no-unlock 开关
   svn commit -m "提交我的测试用test.php" -N --no-unlock test.php
   
   # 注意这个 * 表示全部文件
   svn ci -m "提交当前目录下的全部在版本控制下的文件" *
   
   # 提交test.php
   svn ci -m "提交我的测试用test.php" test.php
   
   # 保持锁就用 –no-unlock 开关
   svn ci -m "提交我的测试用test.php" -N --no-unlock test.php
   

5. 更新文件

   svn update
   svn update -r 修正版本 文件名
   svn update 文件名
   

   示例：

   svn update ＜－后面没有目录，默认将当前目录以及子目录下的所有文件都更新到最新版本
   svn update -r 200test.cpp ＜－ 将版本库中的文件 test.cpp还原到修正版本（revision）200
   svnupdate test.php＜－ 更新与版本库同步。
   

   P.S

   提交的时候提示过期冲突，需要先 update 修改文件，然后清除 svn resolved，最后再提交 commit

6. 删除文件

   # 直接通过 SVN 服务器删除文件或者目录（不推荐）
   svn delete svn://路径(目录或文件的全路径) -m "删除备注信息文本"
   
   # 推荐如下操作
   svn delete 文件名  
   svn ci -m "删除备注信息文本"  
   

   示例：

   # 直接通过 SVN 服务器删除文件或者目录（不推荐）
   svn delete svn://localhost/testapp/test.php -m "删除测试文件test.php"
   
   # 推荐如下操作
   svn delete test.php
   svn ci -m "删除测试文件test.php"
   

7. 加锁/解锁

   svn lock -m "加锁备注信息文本" [--force] 文件名  
   svn unlock 文件名
   

   示例：

   svn lock -m "锁信测试用test.php文件" test.php 
   svn unlock test.php
   

8. 比较差异

   svn diff 文件名 
   svn diff -r 修正版本号m:修正版本号n 文件名
   

   示例：

   # 将修改的文件与基础版本比较
   svn diff test.php
   # 对修正版本号200 和 修正版本号201 比较差异
   svn diff -r 200:201 test.php
   

9. 查看文件或者目录状态

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

   P.S

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

10. 查看日志

    svn log 文件名
    

    示例：

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

11. 查看文件详细信息

    svn info 文件名
    

    示例：

    svn info test.php
    

12. SVN 帮助

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

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

    svn list svn://路径(目录或文件的全路径)
    svn ls svn://路径(目录或文件的全路径)
    

    示例：

    svn list svn://localhost/test
    # 显示svn://localhost/test目录下的所有属于版本库的文件和目录
    svn ls svn://localhost/test 
    

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

    svn mkdir 目录名
    svn mkdir -m "新增目录备注文本" http://目录全路径
    

    示例：

    svn mkdir newdir
    svn mkdir -m "Making a new dir." svn://localhost/test/newdir 
    

    P.S

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

      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'
      

15. 恢复本地修改

    svn　revert　[--recursive]　文件名
    

    P.S

    本子命令不会存取网络，并且会解除冲突的状况。但是它不会恢复被删除的目录。

    示例：

    # 丢弃对一个文件的修改
    svn revert foo.c
    
    # 恢复一整个目录的文件，.为当前目录 
    svn revert --recursive .
    

16. 把工作拷贝更新到别的 URL

    svn switch http://目录全路径 本地目录全路径
    

    示例：

    # (原为123的分支)当前所在目录分支到localhost/test/456
    svn switch http://localhost/test/456 .
    

17. 解决冲突

    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 让你的工作拷贝知道你已经完成了所有事情。你可以仅仅删除冲突的文件并且提交，但是 svnresolved 除了删除冲突文件，还修正了一些记录在工作拷贝管理区域的记录数据，所以我们推荐你使用这个命令。

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

    svn　cat　http://文件全路径
    

    示例：

    svn cat http://localhost/test/readme.txt
    

19. 新建一个分支 copy

    # 从branchA拷贝出一个新分支branchB
    svn copy branchAbranchB  -m "make B branch"
    

20. 合并内容到分支 merge

    # 把对branchA的修改合并到分支branchB
    svn merge branchAbranchB
    

二、TortoiseSVN 客户端工具功能详解

• TortoiseSVN 是 Windows 下一个非常优秀的 SVN 客户端工具。通过使用它，我们可以可视化的管理我们的版本库。不过由于它只是一个客户端，所以它不能对版本库进行权限管理。

• TortoiseSVN 不是一个独立的窗口程序，而是集成在 Windows 右键菜单中，使用起来比较方便。

• TortoiseSVN 每个菜单项都表示什么意思

1. SVN Checkout

   点击 SVN Checkout，弹出检出提示框，在 URL of repository 输入框中输入服务器仓库地址，在 Checkout directory 输入框中输入本地工作拷贝的路径，点击确定，即可检出服务器上的配置库。

2. SVN Update

   如果配置库在本地已有工作拷贝，则取得最新版本只是执行 SVN Update 即可，点击 SVN Update，系统弹出更新提示框，点击确定，则把服务器是最新版本更新下来

3. Import

   选择要提交到服务器的目录，右键选择 TortoiseSVN----Import，系统弹出导入提示框，在 URL of repository 输入框中输入服务器仓库地址，在 Import Message 输入框中输入导入日志信息，点击确定，则文件导入到服务器仓库中。

4. Add

   如果有多个文件及文件夹要提交到服务器，我们可以先把这些要提交的文件加入到提交列表中，要执行提交操作，一次性把所有文件提交，如图，可以选择要提交的文件，然后点击执行提交（SVN Commit）,即可把所有文件一次性提交到服务器上

5. Resolving Conflicts

   有时你从档案库更新文件会有冲突。冲突产生于两人都修改文件的某一部分。解决冲突只能靠人而不是机器。当产生冲突时，你应该打开冲突的文件，查找以<<<<<<<开始的行。冲突部分被标记：

   <<<<<<< filename
   your changes
   =======
   code merged from repository
   >>>>>>> revision
   

   Subversion 为每个冲突文件产生三个附加文件：

   filename.ext.mine
   更新前的本地文件。
   filename.ext.rOLDREV
   你作改动的基础版本。
   filename.ext.rNEWREV
   

   更新时从档案库得到的最新版本。使用快捷菜单的编辑冲突 Edit Conflict 命令来解决冲突。然后从快捷菜单中执行已解决 Resolved 命令，将改动送交到档案库。请注意，解决命令并不解决冲突，而仅仅是删除 filename.ext.mineandfilename.ext.r* 文件并允许你送交。

6. Check for Modifications

   点击 Check for Modifications ,系统列表所以待更新的文件及文件夹的状态

7. Revision Graph

   查看文件的分支,版本结构,可以点击 Revision Graph,系统以图形化形式显示版本分支

8. Rename

   SVN 支持文件改名,点击 Rename,弹出文件名称输入框,输入新的文件名称,点击确定,再把修改提交,即可完成文件改名

9. Delete

   SVN 支持文件删除,而且操作简单,方便,选择要删除的文件,点击 Delete,再把删除操作提交到服务器

10. Moving

    选择待移动的文件和文件夹；按住右键拖动 right-drag 文件（夹）到跟踪拷贝内的新地方；松开左键；在弹出菜单中选择 move files in Subversion to here

11. Revert

    还原操作,如刚才对文件做了删除操作,现在把它还原回来,点击删除后,再点击提交,会出现如上的提示框,点击删除后,再点击 Revert,即已撤销删除操作,如果这时候点击提交,则系统弹出提示框:没有文件被修改或增加,不能提交

12. Branch/Tag

    当需要创建分支，点击 Branch/Tag，在弹出的提示框中，输入分支文件名，输入日志信息，点击确定，分支创建成功，然后可查看文件的版本分支情况

13. Switch

    文件创建分支后，你可以选择在主干工作，还是在分支工作，这时候你可以通过 Switch 来切换。

14. Merge

    主干和分支的版本进行合并，在源和目的各输入文件的路径，版本号，点击确定。系统即对文件进行合并，如果存在冲突，请参考冲突解决。

15. Export

    把整个工作拷贝导出到本地目录下,导出的文件将不带svn文件标志,文件及文件夹没有绿色的 √ 符号标志。

16. Relocate

    当服务器上的文件库目录已经改变，我们可以把工作拷贝重新定位，在 To URL 输入框中输入新的地址

17. Add to Ignore List

    大多数项目会有一些文件（夹）不需要版本控制，如编译产生的 *.obj, *.lst,等。每次送交，TortoiseSVN 提示那些文件不需要控制，挺烦的。这时候可以把这些文件加入忽略列表。

18. SVN 其它相关功能

    客户端修改用户密码:

    打开浏览器,在地址栏内输入 http://192.168.1.250/cgi-bin/ChangePasswd
    
    启动客户端修改用户密码的界面,输入正确的用户名,旧密码,新密码(注意密码的位数应该不小于6,尽量使用安全的密码)
    
    点击修改即可
    

19. SVN Commit

    把自己工作拷贝所做的修改提交到版本库中，这样别人在获取最新版本(Update)的时候就可以看到你的修改了。

20. Show log

    显示当前文件(夹)的所有修改历史。SVN 支持文件以及文件夹独立的版本追溯。

21. Repo-Browser

    查看当前版本库，这是 TortoiseSVN 查看版本库的入口，通过这个菜单项，我们就可以进入配置库的资源管理器，然后就可以对配置库的文件夹进行各种管理，相当于我们打开我的电脑进行文件管理一样。

22. Revision Graph

    查看当前项目或文件的修订历史图示。如果项目比较大型的话，一般会建多个分支，并且多个里程碑（稳定版本发布），通过这里，我们就可以看到项目的全貌。

23. Resolved

    如果当前工作拷贝和版本库上的有冲突，不能自动合并到一起，那么当你提交修改的时候，TortoiseSVN 就会提示你存在冲突，这时候你就可以通过这个菜单项来解决冲突。冲突的解决有两种，一种是保留某一份拷贝，例如使用配置库覆盖当前工作拷贝，或者反过来。还有一种是手动解决冲突，对于文本文件，可以使用 TortoiseSVN 自带的工具，它会列出存在冲突的地方，然后你就可以和提交者讨论怎么解决这个冲突。同时它也对 Word 有很好的支持

24. Update to Revision

    从版本库中获取某一个历史版本。这个功能主要是方便查看历史版本用，而不是回滚版本。注意：获取下来之后，对这个文件不建议进行任何操作。如果你做了修改，那么当你提交的时候 SVN 会提示你，当前版本已失效（即不是最新版本），无法提交，需要先 update 一下。这样你所做的修改也就白费了。

25. Revert

    如果你对工作拷贝做了一些修改，但是你又不想要了，那么你可以使用这个选项把所做的修改撤销

26. Cleanup

    如果当前工作拷贝有任何问题的话，可以使用这个选项进行修正。例如，有些文件原来是版本控制的，但是你没有通过 TortoiseSVN 就直接删除了，但是 TortoiseSVN 还是保留着原来的信息（每个文件夹下都有一个 .svn 的隐藏文件夹，存放着当前文件夹下所有文件夹的版本信息）所以这就会产生一些冲突。可以使用 cleanup 来清理一下。

27. GetLock/ReleaseLock

    如果你不想别人修改某个文件的话，那么你就可以把这个文件进行加锁，这样可以保证只有你对这个文件有修改权。除非你释放了锁，否则别人不可能提交任何修改到配置库中

28. Branch/tag

    • Branch 是分支的意思。例如当在设计一个东西的时候，不同的人有不同的实现，但是没有经过实践检验，谁也不想直接覆盖掉其他人的设计，所以可以引出不同的分支。将来如果需要，可以将这些分支进行合并。

    • tag 是打标签的意思。通常当项目开发到一定程度，已经可以稳定运行的时候，可以对其打上一个标签，作为稳定版。将来可以方便的找到某个特定的版本（当然我们也可以使用版本号来查找，但是数字毕竟不方便）

    • SVN 对于分支和标签都是采用类似 Linux 下硬链接的方式（同一个文件可以存在两个地方，删除一个不会影响另一个，所做修改会影响另一个），来管理文件的，而不是简单的复制一份文件的拷贝，所以不会有浪费存储空间的问题存在。

29. Export

    这个功能是方便我们部署用。当我们需要发布一个稳定版本时，就可以使用这个功能将整个工程导出到某个文件夹，新的文件夹将不会包含任何版本信息了。

30. Relocate

    当我们版本库发生转移的时候就需要用到这个功能了。例如我原先的版本库是建在U盘上的，现在转移到（复制整个配置库文件夹）开发服务器上，使用https代替文件系统的访问。因此就需要将原来的工作拷贝的目标版本库重新定位到开发服务器上。

31. create patch

    创建补丁。如果管理员不想让任何人都随便提交修改，而是都要经过审核才能做出修改，那么其他人就可以通过创建补丁的方式，把修改信息（补丁文件）发送给管理员，管理员审核通过之后就可以使用 apply patch 提交这次修改了。