svn常用命令说明

SVN版本：1.5 及更新版本

名词说明：

WC：Working Copy 你的工作区

Versioned：受控的；受版本控制的

 

SVN是什么？

 

• SVN是开源的版本控制系统。
• 比CVS更多的特性。一个更好的CVS？因此SVN具有大部分CVS拥有的特性。
• 不仅仅是文件受控，目录也加入版本控制。
• 复制，删除，重命名这些操作都是受控的。
• 特殊作用的元数据（属性）。
• 提交事务原子性。提交完成之前任何一个部分都不会正真生效。版本号基于提交，而不是基于文件。提交时的log message也是依附于提交的那个版本。
• 创建分支和标记非常简单。简单的通过copy命令就可以创建分支和标记。
• 合并跟踪。在合并时协助你处理所有的更改点。
• 文件锁定。svn支持文件锁定修改策略。
• Unix的link可以受控了。前提是WC必须在Unix下。
• 可选的Apache network server，基于WEBDAV/DeltaV 协议。熟悉Apache的管理员会很喜欢这一点。
• 内置的server选择（svnserve）。如果不想用Apache，可以试试Svn自己的server：svnserve。同样也能提供授权和验证，ssh通道等功能。
• 方便解析的输出。svn的输出尽量做到方便阅读和方便机器解析。
• 冲突解决交互性良好。svn命令行客户端提供多种不同的方式解决冲突。
• svn提供一个实用工具，svnsync来实现从主库到只读附属库的同步。
• 持续写入代理功能让只读的附属库专门处理所有的读请求。所有的写请求交给主库处理。这个功能只在使用Apache WebDAV server的时候才有效。
• 基于本地化的客户机服务器体系，分层的库，明晰的API方便扩展。
• 高效处理二进制文件。
• 性能消耗与更改点的数量成正比。
• svn的api可以和多种语言集成。Python，Perl,Java,Ruby（svn本身是用C写的）
• ChangeLists功能。

Svn的安装分客户端和服务端。

你可以在如下地址找到下载：http://subversion.tigris.org/

这篇文章主要介绍的是svn客户端的命令，你至少需要安装客户端。默认就是以SVN做版本控制的。如果你不想在自己机器上安装服务版，google code是个练习svn命令的好地方。

http://code.google.com上申请托管项目很简单，但是现在不支持svn lock。目前最大支持1G空间。

 

以下是svn客户端常用命令一览：

1、检出 
svn  co  http://路径(目录或文件的全路径) [本地目录全路径]  --username 用户名 --password 密码svn  co  svn://路径(目录或文件的全路径) [本地目录全路径]  --username 用户名 --password 密码 
svn  checkout  http://路径(目录或文件的全路径) [本地目录全路径] --username 用户名 
svn  checkout  svn://路径(目录或文件的全路径) [本地目录全路径]  --username 用户名 
注：如果不带--password 参数传输密码的话，会提示输入密码，建议不要用明文的--password 选项。 
其中 username 与 password前是两个短线，不是一个。 
不指定本地目录全路径，则检出到当前目录下。 
例子： 
svn co svn://192.168.0.3/测试工具 /home/testtools --username wzhnsc 
svn co http://192.168.0.3/test/testapp --username wzhnsc 
svn checkout svn://192.168.0.3/测试工具 /home/testtools --username wzhnsc 
svn checkouthttp://192.168.0.3/test/testapp --username wzhnsc 
2、导出(导出一个干净的不带.svn文件夹的目录树) 
svn export [-r 版本号]  http://路径(目录或文件的全路径) [本地目录全路径] --username 用户名 
svn export [-r 版本号]  svn://路径(目录或文件的全路径) [本地目录全路径] --username 用户名 
svn export 本地检出的(即带有.svn文件夹的)目录全路径  要导出的本地目录全路径 
注：第一种从版本库导出干净工作目录树的形式是指定URL， 
如果指定了修订版本号，会导出相应的版本， 
如果没有指定修订版本，则会导出最新的，导出到指定位置。 
如果省略 本地目录全路径，URL的最后一部分会作为本地目录的名字。 
第二种形式是指定 本地检出的目录全路径 到要导出的本地目录全路径，所有的本地修改将会保留， 
但是不在版本控制下(即没提交的新文件，因为.svn文件夹里没有与之相关的信息记录)的文件不会拷贝。 
例子： 
svn export svn://192.168.0.3/测试工具 /home/testtools --username wzhnsc 
svn export http://192.168.0.3/test/testapp --username wzhnsc 
svn export /home/testapp /home/testtools 

3、添加新文件  
svn add 文件名 
注：告诉SVN服务器要添加文件了，还要用svn commit -m真实的上传上去！ 
例子： 
svn add test.php ＜－ 添加test.php  
svn commit -m “添加我的测试用test.php“ test.php 
svn add *.php ＜－ 添加当前目录下所有的php文件 
svn commit -m “添加我的测试用全部php文件“ *.php 
4、提交 
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开关 
5、更新文件 
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。 
6、删除文件 
svn delete svn://路径(目录或文件的全路径) -m “删除备注信息文本” 
推荐如下操作： 
svn delete 文件名  
svn ci -m “删除备注信息文本” 
例子： 
svn delete svn://192.168.1.1/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 
8、比较差异 
svn diff 文件名  
svn diff -r 修正版本号m:修正版本号n文件名 
例子： 
svn diff test.php＜－ 将修改的文件与基础版本比较 
svn diff -r 200:201 test.php＜－ 对修正版本号200 和 修正版本号201 比较差异 
9、查看文件或者目录状态 
svn st 目录路径/名 
svn status 目录路径/名＜－ 目录下的文件和子目录的状态，正常状态不显示  
【?：不在svn的控制中；  M：内容被修改；C：发生冲突； 
A：预定加入到版本库；K：被锁定】  
svn  -v 目录路径/名 
svn status -v 目录路径/名＜－ 显示文件和子目录状态 
【第一列保持相同，第二列显示工作版本号， 
第三和第四列显示最后一次修改的版本号和修改人】  
注：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://192.168.0.3/test 
svn ls svn://192.168.0.3/test ＜－ 显示svn://192.168.0.3/test目录下的所有属于版本库的文件和目录  
14、创建纳入版本控制下的新目录 
svn mkdir 目录名 
svn mkdir -m "新增目录备注文本" http://目录全路径 
例子： 
svn mkdir newdir 
svn mkdir -m "Making a new dir." http://192.168.0.3/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://192.168.0.3/test/newdir/newsubdir 命令， 
SVN提示： 
svn: File already exists: filesystem '/data/svnroot/test/db', transaction '4541-1', 
path '/newdir/newsubdir ' 
15、恢复本地修改 
svn revert [--recursive] 文件名 
注意: 本子命令不会存取网络，并且会解除冲突的状况。但是它不会恢复被删除的目录。 
例子： 
svn revert foo.c ＜－ 丢弃对一个文件的修改 
svn revert --recursive . ＜－恢复一整个目录的文件，. 为当前目录  
16、把工作拷贝更新到别的URL  
svn switch http://目录全路径 本地目录全路径 
例子： 
svn switch http://192.163.0.3/test/456 . ＜－ (原为123的分支)当前所在目录分支到192.163.0.3/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让你的工作拷贝知道你已经完成了所有事情。 
你可以仅仅删除冲突的文件并且提交，但是svn resolved除了删除冲突文件，还修正了一些记录在工作拷贝管理区域的记录数据，所以我们推荐你使用这个命令。 
18、不checkout而查看输出特定文件或URL的内容  
svn cat http://文件全路径 
例子： 
svn cat http://192.168.0.3/test/readme.txt

 

svn add [path]

别名：无

描述：添加文件或目录到你的wc，打上新增标记。这些文件会在下一次你提交wc的时候提交到svn服务器。

在提交前，你也可以用svn revert撤销新增的文件。

访问库：否

eg: svn add file.cpp

 

svn blame Target[@REV]

别名：praise,annotate,ann

描述：显示某个已受控文件的每一行的最后修改版本和作者

访问库：是

eg: svn blame file.cpp

eg: svn blame --xml file.cpp  ##加上xml参数可以以xml格式显示每一行的属性。

 

svn cat TARGET[@REV]

别名：无

描述：输出指定目标的内容，这里的目标一般是文件。

访问库：是

eg:svn cat file.cpp

eg:svn cat file.cpp -r 2 ##显示版本号为二的file.cpp内容。

eg:svn cat file.cpp --revision HEAD ##显示最新版本的file.cpp内容。

 

svn changelist CLNAME TARGET...

svn changelist --remove TARGET

别名：cl

描述：可以将wc中的文件从逻辑上分组.

访问库：否

eg:svn cl clName file.cpp file2.cpp file3.cpp  ##将file.cpp等三个文件加入名叫clName的changelist 

eg:svn commit --changelist clName -m "ci"  ##将clName下的所有文件提交

 

svn checkout URL[@REV]... [PATH]

别名：co

描述：检出

访问库：否

eg:svn checkout file:///var/svn/repos/test  file:///var/svn/repos/quiz working-copies

eg:svn checkout -r 2 file:///var/svn/repos/test mine  ##check out 版本号为2的项目

 

svn cleanup [PATH...]

别名：无

描述：递归的清理WC中过期的锁和未完成的操作。

访问库：否

eg：svn cleanup

 

svn commit [PATH...]

别名：ci

描述：把你WC的更改提交到仓库

访问库：是

eg：svn commit -m "added howto section." ##默认情况下提交必须提供log message 

 

svn copy SRC[@REV]... DST

别名：cp

描述:copy操作可以从WC到WC；WC到URL；URL到WC；URL到URL。现在SVN只支持同一个仓库内文件的拷贝，不允许跨仓库操作。

访问库：是

eg：svn copy -r 11 file:///var/svn/repos/test/trunk \

           file:///var/svn/repos/test/tags/0.6.32-prerelease \

           -m "Forgot to tag at rev 11"

##copy命令是创建分支和标记的常用方式。copy到url的操作隐含了提交动作，所以需要提供log messages。

 

svn delete PATH...

别名：del，remove，rm

描述：删除

访问库：如果PATH是库地址时会，删除WC内的文件不会。

eg：svn del localfile.cpp    ##删除WC里的文件，在下一次提交WC的时候才会真正在仓库里将对应文件删除。

eg: svn del file:///var/svn/repos/test/yourfile  ##删除仓库里的文件

 

svn diff

别名：di

描述：用来比较并显示修改点。

访问库：

eg：svn diff   ##最常用的方式，用来显示WC基于最近一次更新以后的所有的本地修改点。

eg：svn diff -r 301 bin ## 比较WC和版本301中的bin目录的修改点

eg：svn diff -r 3000:3500 file:///var/svn/repos/myProject/trunk   ##比较库里主干3000版和3500版的差异。

eg：svn diff --summarize --xml http://svn.red-bean.com/repos/test@r2 http://svn.red-bean.com/repos/test  ##--summarize --xml 参数将差异情况以xml文档的方式显示出来。

 

svn export [-r REV] URL[@PEGREV] [PATH]

svn export [-r REV] PATH1[@PEGREV] [PATH2]

别名：无

描述：导出一个干净的目录树，不包含所有的受控信息。可以选择从URL或WC中导出。

访问库：如果访问的是URL则会。

eg：svn export file:///var/svn/repos my-export   ##导出到my-export目录。

 

svn help — Help!

别名：?,h

描述：不用解释了

访问库：否。

 

svn import [PATH] URL

别名：无

描述：导入本地一个目录到库中。但是导入后，本地的目录并不会处于受控状态。

访问库：是。

eg：svn import -m "New import" myproj http://svn.myProject.com/repos/trunk/misc

 

svn info [TARGET[@REV]...]

别名：无

描述：显示指定WC和URL信息。

访问库：仅当访问的是库路径时。

eg：svn info --xml http://svn.myProject.com/repos/test  ##将信息以xml格式显示。

 

svn list [TARGET[@REV]...]

别名：ls

描述：显示目标下的文件和目录列表。

访问库：如果访问的是库地址就会。

eg：svn list --verbose file:///var/svn/repos   ##--verbose参数表示显示详细信息。

 

svn lock TARGET...

别名：无

描述：对目标获得修改锁。如果目标已被其他用户锁定，则会抛出警告信息。用--force参数强制从其他用户那里获得锁。

访问库：是

eg：svn lock --force tree.jpg

 

svn log [PATH]

svn log URL[@REV] [PATH...]

别名：无

描述：从库中显示log消息。log消息代码 A ：added  D：deleted  M：modified  R：replaced

访问库：是

eg：svn log -v http://svn.myProject.com/repos/test/ foo.c bar.c   ##详细显示指定URL的库中foo.c和bar.c所有版本的log信息。

eg：svn log -r 14:15    ##显示当前WC的14和15版本log信息。

eg：##如果版本号不连续，只能采用如下方式。

$ svn log -r 14 > mylog

$ svn log -r 19 >> mylog

$ svn log -r 27 >> mylog

 

svn merge sourceURL1[@N] sourceURL2[@M] [WCPATH]

svn merge sourceWCPATH1@N sourceWCPATH2@M [WCPATH]

svn merge [[-c M]... | [-r N:M]...] [SOURCE[@REV] [WCPATH]]

别名：无

描述：合并两个受控源的不同之处，存放到一个WC里。

访问库：只有当访问库地址时。

eg：svn merge --reintegrate http://svn.example.com/repos/calc/branches/my-calc-branch  ##合并分支上的改变项到WC，往往用于分支合并到主干。

eg：svn merge -r 156:157 http://svn.example.com/repos/calc/branches/my-calc-branch   ##将制定URL版本156到157的所有更新合并到WC。

 

svn mkdir PATH...

svn mkdir URL...

别名：无

描述：在WC或库路径创建目录

访问库：只有当访问库地址时。

eg：svn mkdir newdir

 

svn move SRC... DST

别名：mv, rename, ren

描述：等同于svn copy命令跟个svn delete命令。WC到URL的重命名是不被允许的。

访问库：只有当访问库地址时。

eg：svn move foo.c bar.c  ##将foo.c改名成bar.c。

 

svn propdel PROPNAME [PATH...]

svn propdel PROPNAME --revprop -r REV [TARGET]

别名：pdel, pd

描述：从受控文件，目录等删除属性。第二种是删除某个指定版本上的附加属性。

访问库：只有当访问库地址时。

eg：svn propdel svn:mime-type someFile    ##从someFile上移除svn:mime-type这个属性。

 

svn propedit PROPNAME TARGET...

svn propedit PROPNAME --revprop -r REV [TARGET]

别名：pedit, pe

描述：编辑属性

访问库：只有当访问库地址时。

eg：svn propedit svn:keywords  file.c  ##修改file.c上的svn:keywords属性。

 

svn propget PROPNAME [TARGET[@REV]...]

svn propget PROPNAME --revprop -r REV [URL]

别名：pget,pg

描述：从文件，目录或版本取得指定属性的值。

访问库：只有当访问库地址时。

eg：svn propget svn:keywords file.c   ##从file.c中取得svn:keywords属性的值

 

svn proplist [TARGET[@REV]...]

svn proplist --revprop -r REV [TARGET]

别名：plist, pl

描述：列出文件、目录或版本上的所有附加属性

访问库：只有当访问库地址时。

eg：svn proplist --verbose file.c

 

svn propset PROPNAME [PROPVAL | -F VALFILE] PATH...

svn propset PROPNAME --revprop -r REV [PROPVAL | -F VALFILE] [TARGET]

别名：pset,ps

描述：给文件、目录或版本附加属性并赋值

访问库：只有当访问库地址时。

eg：svn propset svn:mime-type image/jpeg file.jpg   ##给file.jpg附加属性svn:mime-type 其值为image/jpeg

eg:svn propset --revprop -r 25 svn:log "Journaled about trip to New York."

##给版本25补上log message

eg:svn propset svn:ignore '.classpath' . 

##在本地忽略掉.classpath文件

 

svn resolve PATH...

别名：无

描述：将冲突的文件标记为已解决，并且删掉冲突产生的临时文件。注意这个命令并不是能把冲突解决，解决冲突还是得靠人工。

访问库：否

eg：svn resolve --accept mine-full foo.c   ##1.5版本后，加上--accept参数，尝试自动处理冲突。

 

svn resolved PATH...

别名：无

描述：已过时，被resolve --accept取代。去除冲突的状态和冲突临时文件。

访问库：否

 

svn revert PATH...

别名：无

描述：还原WC中所有的本地更改。

访问库：否

eg：svn revert --depth=infinity .   ##将整个目录所有文件还原

 

svn status [PATH...]

别名：stat, st

描述：输出WC中文件和目录的状态。如果WC提交，这些状态就会同步到库里。

一般状态有         ' '  没有修改

'A'  新增

'D'  删除

'M'  修改

'R'  替代

'C'  冲突

'I'  忽略

'?'  未受控

'!'  丢失，一般是将受控文件直接删除导致

访问库：加上--show-updates参数时会

eg：svn status wc

 

svn switch URL[@PEGREV] [PATH]

svn switch --relocate FROM TO [PATH...]

别名：sw

描述：将WC转向一个其他的库地址同步

访问库：是

eg：svn sw http://svn.myProject.com/repos/trunk/vendors .  ##将当前WC切换到另一个URL

 

svn unlock TARGET...

别名：无

描述：解锁

访问库：是

eg：svn unlock somefile

 

svn update [PATH...]

别名：up

描述：更新WC，更新反馈有如下几种分类。

        A  新增

B  锁破坏

D  删除

U  更新

C  冲突

G  合并

E  存在的

访问库：是

eg：svn up -r22   ##更新到一个指定版本

 

ps:如何去除SVN中保存的用户授权密码

在Subversion安装目录下找到auth/svn.simple目录，将下面的文件删除即可。

如果在乌龟中，可以setting->saved data->Authentication Data   点 clear 即可。

 

参考资料：http://svnbook.red-bean.com/en/1.5/svn.ref.svn.c.checkout.html