SVN(Subversion)和git类似,是一个开源的版本控制软件,分为服务端和客户端,和git不同的是:SVN的工作区和版本库是分开的。一种典型的模式为:在企业开发中,版本库一般位于服务器上,每个用户都从这个版本库获取代码到自己的工作区,工作区的修改也提交到服务器上的版本库。本文主要介绍客户端的svn命令使用方法。
1、检出(checkout)
通俗地讲,检出就是把服务器上的代码仓库拷贝一份到本地工作区,建立客户端和服务器端的联系。这样,本地工作区的修改可以提交到服务器,或者服务器的仓库也可以更新到本地。
命令:
- svn checkout(简写co) http://路径(目录或代码完整路径) [本地路径] –username 用户名 –password
- svn checkout http://路径(目录或文件的全路径) [本地目录全路径] –username 用户名
- svn checkout svn://路径(目录或文件的全路径) [本地目录全路径] –username 用户名
【注】如果不带–password 参数传输密码的话,会提示输入密码,建议不要用明文的–password 选项。
例子:
- svn co svn://localhost/测试工具 /home/testtools –username vaosamo
- svn co http://localhost/test/testapp –username vosamo
- svn checkout svn://localhost/测试工具 /home/testtools –username vosamo
- svn checkout http://localhost/test/testapp –username vosamo
2、导入(import)
导入是指将本地的普通目录或文件导入到远端的版本库中,然后再checkout一下就可以得到本地工作区了。它与add的区别在于add是将新的文件纳入本地工作区的版本控制之下,commit之后才导入版本库;而import是至直接将未版本化的文件直接导入到版本库。
命令:
svn import mytree http://localhost/test/testapp -m “Initial import”
导入之后原来的目录树没有转化成工作拷贝,为了开始工作,还是需要运行svn checkout导出一个工作拷贝。
3、导出(export)
导出也是从远程仓库导出一份拷贝到本地。那么导出和检出有什么区别呢?检出得到的是一个带版本控制的仓库,包含.svn目录;而导出得到的是一个不含.svn目录的不带版本控制的干净的拷贝。
命令:
- svn export [-r 版本号] http://路径(目录或文件的全路径) [本地目录全路径] –username 用户名
- svn export [-r 版本号] svn://路径(目录或文件的全路径) [本地目录全路径] –username 用户名
- svn export 本地检出的(即带有.svn文件夹的)目录全路径 要导出的本地目录全路径
【注】第一种从版本库导出干净工作目录树的形式是指定URL,如果指定了修订版本号,会导出相应的版本,如果没有指定修订版本,则会导出最新的,导出到指定位置。如果省略 本地目录全路径,URL的最后一部分会作为本地目录的名字。 第二种形式是指定 本地检出的目录全路径 到 要导出的本地目录全路径,所有的本地修改将会保留,但是不在版本控制下(即没提交的新文件,因为.svn文件夹里没有与之相关的信息记录)的文件不会拷贝。
例子:
- svn export svn://localhost/测试工具 /home/testtools –username wzhnsc
- svn export svn://localhost/test/testapp –username wzhnsc
- svn export /home/testapp /home/testtools
4、添加新文件add
命令: svn add 文件名
【注】当在本地工作区新建一个文件时,这个新文件是不被track的,所以要用add命令把它纳入版本控制,这样就可以被追踪到了。在下一次提交的时候,它就可以被提交到版本库了。
例子:
- svn add test.php <- 添加test.php
- svn commit -m “添加我的测试用test.php“ test.php
- svn add *.php <- 添加当前目录下所有的php文件
- svn commit -m “添加我的测试用全部php文件“ *.php
5、提交commit
提交就是把本地的仓库修改提交到远程仓库。
命令:
- svn commit -m “提交备注信息文本“ [-N] [–no-unlock] 文件名
- svn ci -m “提交备注信息文本“ [-N] [–no-unlock] 文件名
【注】必须带上-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开关
6、更新文件update
更新文件就是把远程仓库更新到本地,做一个同步。本地工作区的代码可能不是最新的,在多人协作开发中尤其这样,别人可能随时提交新的代码,为了保持一致,最好每次都update一下。
命令:
- 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。
7、删除文件delete
svn delete命令既可以删除本地工作区版本控制之下的文件,也可以删除远程版本库的文件。
命令:
- svn delete svn://路径(目录或文件的全路径) -m “删除备注信息文本” 推荐如下操作:
- svn delete 文件名
- svn ci -m “删除备注信息文本” <- ci是commit的简写
例子:
- svn delete svn://localhost/testapp/test.php -m “删除测试文件test.php” <-直接删除远端仓库的文件
推荐如下操作:先删除本地工作区的文件,然后提交到远程版本库
- svn delete test.php
- svn ci -m “删除测试文件test.php” <- ci是commit的简写
8、加锁/解锁
多人协作开发过程中,容易出现多人修改同一文件的情况。这时,如果几个人同时修改并提交同一文件会导致冲突。为了避免这一情况,可以使用加锁功能,你在修改一个文件之前先给它上把锁,这样别人就无法提交对该文件的修改了。
命令:
- svn lock -m “加锁备注信息文本“ [–force] 文件名
- svn unlock 文件名
例子:
- svn lock -m “锁住测试用test.php文件“ test.php
- svn unlock test.php
9、比较差异
命令:
- svn diff 文件名
- svn diff -r 修正版本号m:修正版本号n 文件名
例子:
- svn diff test.php <- 将修改的文件与基础版本比较
- svn diff -r 200:201 test.php<- 对 修正版本号200 和 修正版本号201 比较差异
10、查看文件或者目录状态
命令:
- svn st 目录路径/名
- svn status 目录路径/名<- 目录下的文件和子目录的状态,正常状态不显示 【?:不在svn的控制中; M:内容被修改;C:发生冲突;A:预定加入到版本库;K:被锁定】
- svn st -v 目录路径/名
- svn status -v 目录路径/名<- 显示文件和子目录状态 【第一列保持相同,第二列显示工作版本号,第三和第四列显示最后一次修改的版本号和修改人】
11、查看日志
命令:
- svn log 文件名
例子:
- svn log test.php<- 显示这个文件的所有修改记录,及其版本号的变化
12、查看文件详细信息
命令:
- svn info 文件名
例子:
- svn info test.php
13、SVN 帮助
命令:
- svn help <- 全部功能选项
- svn help ci <- 具体功能的说明
14、查看版本库下的文件和目录列表
命令:
- svn list svn://路径(目录或文件的全路径)
- svn ls svn://路径(目录或文件的全路径)
例子:
- svn list svn://localhost/test
- svn ls svn://localhost/test <- 显示svn://localhost/test目录下的所有属于版本库的文件和目录
15、创建纳入版本控制下的新目录
命令:
- svn mkdir 目录名
- svn mkdir -m ”新增目录备注文本” http://目录全路径
例子:
- svn mkdir newdir <-在本地库创建新目录
- svn mkdir -m “Making a new dir.” svn://localhost/test/newdir <-直接在远程库创建新目录
【注】添加完子目录后,一定要回到根目录更新一下,不然在该目录下提交文件会提示“提交失败” svn update
16、恢复本地修改
注意: 本命令只是在本地操作,表示放弃当前的修改,并把本地工作区的内容恢复为修改之前最新的版本,可以理解成word当中的撤销Ctrl+Z。但是它不会恢复被删除的目录。
命令:
- svn revert [–recursive] 文件名
- svn revert foo.c <- 丢弃对一个文件的修改
- svn revert –recursive . <-恢复一整个目录的文件,. 为当前目录
例子:
在当前工作区中添加一个新文件test:
#修改 test
svn status
#M test<-表示已修改,待提交
svn revert test
svn status
#
17、把工作拷贝更新到别的URL
命令:
- svn switch http://目录全路径 本地目录全路径
例子:
- svn switch http://localhost/test/456 . <- (原为123的分支)当前所在目录分支到localhost/test/456
18、解决冲突
本子命令不会依语法来解决冲突或是移除冲突标记;它只是移除冲突的相关文件,然后让 PATH 可以再次提交。 命令:
- 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除了删除冲突文件,还修正了一些记录在工作拷贝管理区域的记录数据,所以我们推荐你使用这个命令。
19、不checkout而查看输出特定文件或URL的内容
命令:
- svn cat http://文件全路径
例子:
- svn cat http://localhost/test/readme.txt
20、新建一个分支copy
命令:
- svn copy branchA branchB -m “make B branch” // 从branchA拷贝出一个新分支branchB
21、合并内容到分支merge
- svn merge branchA branchB // 把对branchA的修改合并到分支branchB