SVN常用知识简介

05/08/2015 08:39 上午 posted in  杂七杂八

trunk
tags
branches

##常用SVN 命令:

名词说明:
WC:Working Copy 你的工作区
Versioned:受控的;受版本控制的

  1. 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的项目

  2. svn import [PATH] URL
    别名:无
    描述:导入本地一个目录到库中。但是导入后,本地的目录并不会处于受控状态。
    访问库:是。
    eg:svn import myproj http://svn.myProject.com/repos/trunk/misc -m “New import”

  3. 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目录。

  4. svn status [PATH...]
    别名:stat, st
    描述:输出WC中文件和目录的状态。如果WC提交,这些状态就会同步到库里。
    一般状态有         ‘ ‘  没有修改
    ‘A’  新增
    ‘D’  删除
    ‘M’  修改
    ‘R’  替代
    ‘C’  冲突
    ‘I’  忽略
    ‘?’  未受控
    ‘!’  丢失,一般是将受控文件直接删除导致
    访问库:加上--show-updates参数时会 (查看WC与Versioned的状态对比)
    eg:svn status wc

  5. svn add [path]
    别名:无
    描述:添加文件或目录到你的wc,打上新增标记。这些文件会在下一次你提交wc的时候提交到svn服务器。
    在提交前,你也可以用svn revert撤销新增的文件。
    访问库:否
    eg: svn add file.cpp

svn add xxx@2x.png 文件时, 正常命令 svn add xxx@2x.png 会报 xxx not found
需用 svn add xxx@2x.png@  来添加,也就是图片名字后面再添加一个@ 符号,
这是因为 svn 命令最后需要用@符号来指定一个版本导致的
遇到 xxx@2x.png文件时,如果用svn命令行添加到 版本库的话,只能手动一个一个添加,不能批量添加

  1. svn commit [PATH...]
    别名:ci
    描述:把你WC的更改提交到仓库
    访问库:是
    eg:svn commit -m “added howto section.” ##默认情况下提交必须提供log message 

  2. svn revert PATH...
    别名:无
    描述:还原WC中所有的本地更改。
    访问库:否
    eg:svn revert --depth=infinity .   ##将整个目录所有文件还原

  3. svn update [PATH...]
    别名:up
    描述:更新WC,更新反馈有如下几种分类。
    A  新增
    B  锁破坏
    D  删除
    U  更新
    C  冲突
    G  合并
    E  存在的
    访问库:是
    eg:svn up -r22   ##更新到一个指定版本

  4. svn list [TARGET[@REV]...]
    别名:ls
    描述:显示目标下的文件和目录列表。
    访问库:如果访问的是库地址就会。
    eg:svn list --verbose file:///var/svn/repos   ##--verbose参数表示显示详细信息。

  5. svn delete PATH...
    别名:del,remove,rm
    描述:删除
    访问库:如果PATH是库地址时会,删除WC内的文件不会。
    eg:svn del localfile.cpp    ##删除WC里的文件,在下一次提交WC的时候才会真正在仓库里将对应文件删除。
    eg: svn del file:///var/svn/repos/test/yourfile  ##删除仓库里的文件

  6. svn cleanup [PATH...]
    别名:无
    描述:递归的清理WC中过期的锁和未完成的操作。
    访问库:否
    eg:svn cleanup

  7. 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文档的方式显示出来。

eg: svn diff -r 1450:1457 ./JoggersV2/JoggersV2/AppDelegate.m

  1. 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

  2. svn resolve PATH...
    别名:无
    描述:将冲突的文件标记为已解决,并且删掉冲突产生的临时文件。注意这个命令并不是能把冲突解决,解决冲突还是得靠人工。
    访问库:否
    eg:svn resolve --accept mine-full foo.c   ##1.5版本后,加上--accept参数,尝试自动处理冲突。

2)export
描述:创建一个无版本记录的拷贝
简写:ex

示例:
打开终端,cd 进入到要保存工程的目录(此处一个文件名为project)
cd /Users/hupu/Desktop/project

svn export 项目SVN地址

创建一个无版本记录的拷贝.
svn export –r rev URL path
从项目仓库的指定URL导出一个干净的目录树到path中,如果指定了rev参数,导出rev版本的,否则到处最新版本。
3)import
描述:提交一个无版本的文件或者树到项目仓库
svn import path URL

svn commit -m ‘refs# modify’

打开终端,cd 进入到需要上传的.a文件所在的文件夹。 确保 ls能看到.a文件
hupudeiMac:Support hupu$ cd /Users/hupu/Desktop/HP_Project/Joggers/tags/JoggersV2_1.6.0/Support/MTA
hupudeiMac:MTA hupu$ svn add *.a
A (bin) libmtasdk.a

提交命令:
hupudeiMac:tags hupu$ svn ci -m ‘refs# lib submited’

查看本地和远程修改文件的状态命令:svn st --show-updates

常用命令

打开终端,进到所在的目录,然后出入一下代码
find . -name “.svn” | xargs rm -Rf

  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文件)
    svn add xxx@2x.png 文件时, 正常命令 svn add xxx@2x.png 会报 xxx not found
    需用 svn add xxx@2x.png@  来添加,也就是图片名字后面再添加一个@ 符号,
    这是因为 svn 命令最后需要用@符号来指定一个版本导致的
    遇到 xxx@2x.png文件时,如果用svn命令行添加到 版本库的话,只能手动一个一个添加,不能批量添加
  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…
创建版本控制的目录。
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 可以再次提交。
    18、输出指定文件或URL的内容。
svn cat 目标[@版本]…如果指定了版本,将从指定的版本开始查找。
svn cat -r PREV filename > filename (PREV 是上一版本,也可以写具体版本号,这样输出结果是可以提交的)
    19、配置忽略文件 vi ~/.subversion/config
    找到 global-ignores 一行,去掉注释,编辑成
global-ignores = build *~.nib *.so *.pbxuser *.mode *.perspective*
找到 enable-auto-props = yes 把注释去掉,在[auto-props] Section声明以下文本文件
*.mode* = svn:mime-type=text/X-xcode
*.pbxuser = svn:mime-type=text/X-xcode
*.perspective* = svn:mime-type=text/X-xcode
*.pbxproj = svn:mime-type=text/X-xcode

=========================================

##svn 出错信息总汇

-svn 出错信息总汇 . Subversion 错误信息一览表 注意: 不同的客户端(命令行,TortoiseSVN, AnkhSVN, Subclipse等)的出错信息可能稍有不同。 下面表格中的出错信息以 http://svn.moon.ossxp.com/svn/test 版本库做示例,仅供参考。 编号 出错信息 问题剖析 解决方案 1. svn: Server sent unexpected return value (500 I-
svn 出错信息总汇 . Subversion 错误信息一览表
注意:

不同的客户端(命令行,TortoiseSVN, AnkhSVN, Subclipse等)的出错信息可能稍有不同。
下面表格中的出错信息以 http://svn.moon.ossxp.com/svn/test 版本库做示例,仅供参考。
###编号出错信息,问题剖析解决方案
 
1.
svn: Server sent unexpected return value (500 Internal Server Error) in response to OPTIONS request for ‘http://svn.moon.ossxp.com/svn/test'

错误的用户名
检查登录的用户名是否输入错误

svn: 服务器发送了意外的返回值(500 Internal Server Error),在响应 “OPTIONS” 的请求 “http://svn.moon.ossxp.com/svn/test” 中

2.
svn: OPTIONS of ‘http://svn.moon.ossxp.com/svn/test': authorization failed: Could not authenticate to server: rejected Basic challenge (http://svn.moon.ossxp.com)

错误的口令
用正确的用户名/口令登录

svn: 方法 OPTIONS 失败于 “http://svn.moon.ossxp.com/svn/test”: 认证失败: Could not authenticate to server: rejected Basic challenge (http://svn.moon.ossxp.com)

3.
svn: Server sent unexpected return value (403 Forbidden) in response to OPTIONS request for ‘http://svn.moon.ossxp.com/svn/test'

用户无权限
联系管理员,为用户分配权限 
svn: 服务器发送了意外的返回值(403 Forbidden),在响应 “OPTIONS” 的请求 “http://svn.moon.ossxp.com/svn/test” 中
 
4.
svn: OPTIONS of ‘http://www.moon.ossxp.com/svn/test': 200 OK (http://www.moon.ossxp.com)

服务器地址错误,是普通Web页面,不支持SVN的 WebDAV 协议

确认输入正确的 SVN 服务地址。可以在浏览器中输入该地址进行确认
 
svn: 方法 OPTIONS 失败于 “http://www.moon.ossxp.com/svn/test”: 200 OK (http://www.moon.ossxp.com)
 
5.
The version of your subversion (client) is below 1.5.0, upgrade to 1.5.0 or above. SVN below 1.5.0 can not handle mergeinfo properly. It can mess up our automated merge tracking!

是由于客户端的软件版本低于1.5.0造成的。服务器端对客户端软件版本进行了限制,以免对合并跟踪破坏。

升级本地的Subversion客户端软件到1.5.0或以上版本。
 
6.
svn: This client is too old to work with working copy ‘.’. You need to get a newer Subversion client, or to downgrade this working copy. See http://subversion.tigris.org/faq.html#working-copy-format-change for details.

安装了多个版本的SVN客户端(TSVN,Subclipse,...),且各个客户端的版本不一致。高版本的SVN客户端会自动更新本地工作目录中的 .svn 目录下的文件格式,导致旧版本的SVN客户端不能继续访问该本地工作目录

将本机安装的所有的SVN客户端都更新到同一个大版本,以避免本地工作目录的格式不一致
-svn: 此客户端对于工作副本 . 太旧。你需要取得更新的 Subversion 客户端,或者降级工作副本。 参见 http://subversion.tigris.org/faq.html#working-copy-format-change 以获得更详细的信息。 7. svn: Working cop-

svn: 此客户端对于工作副本 “.” 太旧。你需要取得更新的 Subversion 客户端,或者降级工作副本。 参见 http://subversion.tigris.org/faq.html#working-copy-format-change 以获得更详细的信息。

7.
svn: Working copy ‘trunk/src’ locked svn: run ‘svn cleanup’ to remove locks (type ‘svn help cleanup’ for details)

异常操作导致目录没有解锁。
一个简单的重现方法:在 .svn 目录下创建空的名为 lock 的文件

使用命令行 “svn cleanup” 或者类似的“清理”动作删除锁定

svn: 工作副本“trunk/src”已经锁定 svn: 运行“svn cleanup”删除锁定 (输入“svn help cleanup”得到用法)
 
8.
日志中没有作者信息: ------------------------------------ r9 | (没有作者信息) | … ossxp.com anonymous commit test
匿名提交导致没有作者信息
检查版本库权限控制,禁止匿名提交
 
9.
正在发送 ... 传输文件数据.svn: 提交失败(细节如下): svn: Commit blocked by pre-commit hook (exit code 1) with output: 提交说明至少应包含 4 个字符, 或者太简单了。

这是由于用户提交的提交说明(commit log),太过简单了。在提交时需要输入有意义的 commit log。

写有意义的提交说明,或者请求管理员更改版本库插件
10.
增加 Logger.c 传输文件数据.svn: 提交失败(细节如下): svn: Commit blocked by pre-commit hook (exit code 1) with output: Wide character in print at /opt/svn/svnroot/myrepos/hooks/scripts/check-case-insensitive.pl line 259. 发现文件名大小写冲突: trunk/src/Logger.c 已经存在于 logger.c

管理员设置了对新增文件是否重名(只有大小写不同)的文件进行检查。文件名只有大小写不同,在Windows上进行检出会造成麻烦

不要添加重名(仅大小写不同)文件

增加 src/文件aBc.txt 传输文件数据.svn: 提交失败(细节如下): svn: Commit blocked by pre-commit hook (exit code 1) with output: Clash: ‘/trunk/src/文件aBc.txt’ ‘/trunk/src/文件abc.txt’

11.
svn: While preparing ‘/home/jiangxin/tmp/svn.test/trunk/src/README.txt’ for commit svn: Inconsistent line ending style

提交的文件已经设置了 svn:eol-style 属性,但是该文本内的换行符有DOS的换行符CRLF,也有Unix换行符LF,不一致!

统一该文本文件内的换行符。Linux 下可以用dos2unix, unix2dos, sed等命令。Windows下可用 UltraEdit 进行转换。
 
svn: 当为提交操作准备“/home/jiangxin/tmp/svn.test/trunk/src/README.txt”时 svn: 不一致的行结束样式
12.
svn: Failed to add file ‘Makefile’: an unversioned file of the same name already exists

执行更新(svn up)时报错。因为其他人新增一个文件到服务器,而本地却存在一个同名文件(未版本控制)

先将本地重名文件改名,再执行 “svn up”,之后再比较、合并文件。或者执行 “svn up --force”
-svn: 增加文件 ‘Makefile’ 失败: 同名未版本控制的文件已存在 13. Adding src/Makefile svn: Commit failed (details follow): svn: File ‘/svn/test/trunk/src/Makefile’ already exists 添加新文件,提交时报错。-
svn: 增加文件 ‘Makefile’ 失败: 同名未版本控制的文件已存在
 
13.
Adding src/Makefile svn: Commit failed (details follow): svn: File ‘/svn/test/trunk/src/Makefile’ already exists

添加新文件,提交时报错。因为其他人已经先于我增加了该文件。

先执行更新操作(”svn up”),再根据提示进行操作:合并/提交...

增加 src/Makefile svn: 提交失败(细节如下): svn: 文件“/svn/test/trunk/src/Makefile”已存在
 
14.
$ svn up Conflict discovered in ‘Makefile’. Select: (p) postpone, (df) diff-full, (e) edit, (mc) mine-conflict, (tc) theirs-conflict, (s) show all options: p C Makefile Updated to revision 5. Summary of conflicts: Text conflicts: 1
多人同时编辑同一个文件时,可能会遇到冲突。别人先于我提交,则当我提交时要先更新。更新可能遇到不能自动解决的冲突

使用工具进行冲突解决


$ svn up 在 “Makefile” 中发现冲突。 选择: (p) 推迟,(df) 显示全部差异,(e) 编辑, (mc) 我的版本, (tc) 他人的版本, (s) 显示全部选项: p C Makefile 更新到版本 5。 冲突概要: 正文冲突:1
 
15.
svn: Commit failed (details follow): svn: File ‘Makefile’ is out of date svn: File not found: transaction ‘6-d’, path ‘/trunk/src/Makefile’

提交的文件已被他人删除

先执行更新操作(”svn up”),再根据提示解决该树冲突:删除文件或继续添加...

svn: 提交失败(细节如下): svn: 文件 “Makefile” 已经过时 svn: File not found: transaction ‘6-c’, path ‘/trunk/src/Makefile’

16.
svn: Commit failed (details follow): svn: File or directory ‘/trunk/XXX’ is out of date; try updating svn: resource out of date; try updating

基于旧版本修改是不允许的
先更新(”svn update”),再提交 
svn: 提交失败(细节如下): svn: 文件或目录 “/trunk/XXX” 已经过时;请先更新 svn: resource out of date; try updating

17.
svn: DAV request failed; it’s possible that the repository’s pre-revprop-change hook either failed or is non-existent svn: At least one property change failed; repository is unchanged svn: Error setting property ‘log’: Repository has not been enabled to accept revision propchanges; ask the administrator to create a pre-revprop-change hook

修改提交说明等操作属于高风险操作,因为该操作没有被版本控制,属于不可恢复的操作。缺省禁止。

请联系管理员,启用该版本的相关钩子,允许修改“版本属性”。参见 管理员钩子设置


svn: DAV 请求失败;可能是版本库的 pre-revprop-change 钩子执行失败或者不存在 svn: 至少有一个属性变更失败;版本库未改变 svn: 设置属性 “log” 出错: Repository has not been enabled to accept revision propchanges; ask the administrator to create a pre-revprop-change hook