svn 常用操作命令及问题处理

1. 常用命令

1.1. 基本使用

  • 检出 checkout

    # 检出代码
    ➜ svn co repo_url

    # 检出代码,并指定目录名
    ➜ svn co repo_url saved_dir_name
  • 加入版本控制 add

    # 添加指定文件
    ➜ svn add /path/to/file

    # 添加所有 .sh 后缀的文件
    ➜ svn add *.sh

    # 递归添加当前目录下的所有新文件
    # 如果使用参数 --no-ignore 则新增时会包含被设置为忽略的文件
    ➜ svn add . --force
  • 提交 commit

    ➜  svn ci -m '提交更改'
  • 更新 update

    ➜  svn up [file|path]

    # 更新到指定版本 11
    ➜ svn up -r 11 [file|path]
  • 清除锁定 svn cleanup

  • 重定向仓库地址到新地址

    ➜  svn switch --relocate old_repo_url new_repo_url
  • 切换当前项目到指定分支

    ➜  svn switch svn://branch_url
  • 检查工作副本下的文件状态 svn st

  • 查看工作副本的版本库概览信息 svn info

  • 查看版本库上某个目录下的文件列表(不需要本地检出)

    ➜  svn list svn://192.168.1.15/blog

1.2. 分支和标签

  • 创建 branch、tag

    ➜  svn cp svn://trunk_url svn://branch_url -m '创建分支'
    ➜ svn mkdir svn://branch_url -m '创建空分支'
    ➜ svn cp svn://trunk_url tag_url -m '创建标签'
  • 删除 branch、tag

    ➜  svn rm svn://branch_url -m '删除分支'
    ➜ svn rm svn://branch_url -m '删除标签'
  • 查看 branch、tag

    ➜  svn ls ^/branches --verbose
    ➜ svn ls ^/tags --verbose

1.3. 历史记录

  • 查看提交记录

    # 查看整个项目或指定文件目录的提交记录
    ➜ svn log [file|dir]

    # 查看两个指定版本之间的提交记录
    ➜ svn log -r 11:5 [file|dir]

    # 查看最新的 5 条提交记录
    ➜ svn log -l 5 [file|dir]

    # 查看带目录信息的提交记录
    ➜ svn log -l 5 -v [file|dir]
  • 查看指定版本号的文件内容

    ➜  svn cat file -r 版本号
  • 查看文件的修改详情(行级)

    # 比较工作副本下的文件与缓存在 .svn 的“原始”拷贝
    ➜ svn diff

    # 比较工作副本下的文件与指定版本号 5 下的文件
    ➜ svn diff -r 5 file

    # 比较两个版本库下的文件
    ➜ svn diff -r 11:2 file
  • 查看文件每一行的最后修改人

    ➜  svn blame file

1.4. 忽略文件

  • 基本使用

    # 忽略指定文件或目录
    ➜ svn propset svn:ignore 'file|dir' dir

    # 忽略当前目录中所有以 .log 结尾的文件
    # . 表示当前目录,当指定具体目录时,该目录需处于版本控制状态
    ➜ svn propset svn:ignore -R '*.log' .
    ➜ svn ci -m 'ignore *.log file'
  • 要忽略的文件已经被 add 过了

    • 未提交

      ➜  svn revert -R [file|dir]
    • 已提交

      ➜  svn del [file|dir]

      # 只从 svn 中忽略,而不删除本地文件
      ➜ svn del --keep-local [file|dir]

      然后再执行忽略设置并提交。

  • 使用配置文件

    新建 .svnignore 文件,写入类似如下内容:

    runtime
    *.log
    *.apk
    *.class

    然后执行设置

    ➜  svn add .svnignore
    ➜ svn propset svn:ignore -R -F .svnignore .

    提交设置

    ➜  svn ci -m 'add .svnignore and set some ignore'

1.5. 小技巧

  • 创建了一个文件夹,并且把它加入版本控制,但忽略文件夹中的所有内容

    ➜  svn mkdir dir2
    ➜ svn propset svn:ignore '*' dir2
    ➜ svn ci -m 'Adding "dir2" and ignoring its contents.'
  • 创建一个不加入版本控制(忽略)的文件夹

    ➜  mkdir dir1
    ➜ svn propset svn:ignore 'dir1' .
    ➜ svn ci -m 'Ignoring a directory called "dir1".'
  • 导入一个目录 import

    ➜  svn import /tmp/upload svn://192.168.0.1/repo1 -m 'add module upload'

2. 合并 merge

2.1. 分支合并到主干

⚠️注意:分支合并到主干后应当删除该分支,因为在 SVN 中该分支已经不能进行刷新也不能合并到主干。

操作步骤:

# 进入主干目录
cd trunk

# 查看创建分支时的版本号
➜ svn log -q -v -l 1 --stop-on-copy svn://branch_url

# 合并分支上的最新代码到主干
# svn1.8+ 可以不加参数 --reintegrate
➜ svn merge --reintegrate svn://branch_url

# 查看分支中哪些改动已经被合并到主干
➜ svn mergeinfo svn://branch_url

# 查看分支哪些改动还未合并
➜ svn mergeinfo svn://branch_url --show-revs eligible

# ⚠️ 提交本次合并(不提交的话,合并不会生效,也会影响后面的更新操作)
➜ svn ci -m 'merge from branch r11:r5 into trunk'

2.2. 主干合并到分支

# 进入分支目录
cd branch

# 合并之前,可以使用 svn mergeinfo 命令查看主干上有哪些待合并的版本信息
➜ svn mergeinfo -v svn://trunk_url --show-revs eligible --log

# 合并主干上最新代码到分支
➜ svn merge svn://trunk_url

# ⚠️ 提交本次合并(不提交的话,合并不会生效,也会影响后面的更新操作)
➜ svn ci -m 'merge from trunk r11:r5 into branch'

3. 回滚 rollback

3.1. 未提交使用 revert

# 查看文件状态
➜ svn status

# 回滚单个文件
➜ svn revert /path/to/file_name

# 回滚一个目录
➜ svn revert dir_name

# 回滚整个项目
cd trunk
➜ svn revert -R .

3.2. 已提交使用 merge -r

  1. 先更新到最新代码

    # 这里得到最新版本号 11
    ➜ svn up
    Updating '.':
    At revision 11.
  2. 找到要回滚到的版本号

    # 查看最新的 50 次提交记录
    # 最后的参数可以指定文件或目录
    cd trunk
    ➜ svn log -l 50 [file|dir]

    假如我们想要回退到的版本是 5,可以执行命令 svn diff -r 11:5 [file|dir] 简单查看两个版本的区别。

  3. 回滚到指定版本号

    ➜  svn merge -r 11:5 [file|dir]

    验证回滚是否成功

    ➜  svn diff -r [file|dir]
  4. 提交本次回滚操作到仓库

    ➜  svn ci -m "Revert revision from r28 to r25,because of ..."
  5. 其它地方更新本次回滚操作

    ➜  svn up

3.3. 回退误操作的 svn up

场景:我们有一个目录是稳定版本的环境,因为误操作执行了 svn up 后,代码被更新到了仓库中的最新版本,而最新版还没有测试通过,所以我们需要先将更新的代码回滚,如下:

cd trunk
➜ svn merge -r 13410:13962 .

⚠️ 注意:千万不要提交,否则仓库中的代码也会回滚,而我们只希望本地目录回滚。

等到可以执行 svn up 的时候,再恢复:

➜  svn revert -R .
➜ svn up

4. 附录1

4.1. 命令简写对照

  • svn checkout —> svn co
  • svn update —> svn up
  • svn commit —> svn ci
  • svn delete —> svn rmsvn del
  • svn copy —> svn cp
  • svn list —> svn ls
  • svn status —> svn st
  • svn switch —> svn sw
  • svn diff —> svn di

4.2. 处理冲突

# 查找合并时的冲突文件,手工解决冲突
➜ svn st | grep ^C
# 告知svn冲突已解决
➜ svn resolved filename
# 提示合并后的版本
➜ svn commit -m ""
  • (p) postpone 暂时推后处理,我可能要和那个和我冲突的家伙商量一番
  • (df) diff-full 把所有的修改列出来,比比看
  • (e) edit 直接编辑冲突的文件
  • (mc) mine-conflict 如果你很有自信可以只用你的修改,把别人的修改干掉
  • (tc) theirs-conflict 底气不足,还是用别人修改的吧
  • (s) show all options 显示其他可用的命令

4.3. 文件符号状态

  • U: 表示从服务器收到文件更新了
  • G: 表示本地文件以及服务器文件都已更新,而且成功的合并了
  • A: 表示有文件或者目录添加到工作目录
  • R: 表示文件或者目录被替换了.
  • C: 表示文件的本地修改和服务器修改发生冲突

4.4. 如何迁移仓库

  1. 备份源仓库

    ➜  svnadmin dump /path/to/repo > repo.dump
  2. 新建仓库

    ➜  svnadmin create new_repo

    ⚠️ 注意:如果是迁移到 Windows 下,使用 VisualSVN 创建新仓库时,不要创建默认目录结构(branches、trunk、tags),否则在导入备份时候可能因为目录冲突发生报错而中断。

  3. 从备份文件导入新建的仓库

    ➜  svnadmin load /path/to/new_repo < repo.dump

建议:切换代码的 svn 仓库地址时,最好使用新 svn 地址进行重新检出的方式操作;如果直接使用 svn switch --relocate svn://svn_old svn://svn_new 进行切换,有可能报类似 uuid 冲突的错误。

5. 附录2:常见问题处理

5.1. svn: Can't convert string from 'UTF-8' to native encoding

解决

echo "export LC_ALL=zh_CN.UTF-8" >> /etc/profile
source /etc/profile

5.2. SSL handshake failed: SSL 错误:Key usage violation in certificate has been detected.

场景:在 CentOS 服务器上,通过 svn 命令检出 VisualSVN 管理的仓库代码时。

解决:安装高版本的 svn ,如下

  • 添加软件源 vim /etc/yum.repos.d/wandisco-svn.repo

    [WandiscoSVN]
    name=Wandisco SVN Repo
    baseurl=http://opensource.wandisco.com/centos/$releasever/svn-1.8/RPMS/$basearch/
    enabled=1
    gpgcheck=0
  • 删除旧版本 yum remove subversion*

  • 安装新版本

    ➜  yum clean all
    ➜ yum install subversion