【Linux工具】svn命令行使用实例

时间:2023-03-08 17:01:42
  • 引言

  网上有这么多介绍 svn 使用的文章,为什么还要写?因为它们深入不浅出,平铺不分类,理论不实际,看完也记不住。

  本文先介绍基本用法,后进行实例演练。不求大而全,只求熟练常用,自行用 svn help 举一反三(比如 -r 参数很多命令都有)。如果你有环境(别忘了还有服务器),不妨花十分钟跟着实例走一遍。

  简介一下 svn:一种流行的版本管理工具。基于一个 svn 服务器,开发人员用各自的电脑安装 svn 客户端后,就可以实现代码托管、版本管理、协作开发等功能。Windows 上的 svn 客户端有著名的 TortoiseSVN,图形界面非常好用。Linux 众多发行版通常默认安装 svn 命令行客户端(本文介绍的内容)。当然 Linux 下诸如 Eclipse 工具也有图形界面的 svn 客户端插件,同样非常好用。

  欢迎来到 lovickie 的博客 http://www.cnblogs.com/lovickie

  • svn 命令行用法分类概览(中括号[] 内为可选参数)

  命令中的 PATH 参数既可是目录也可是文件。大多数命令都可省略 PATH,缺省为当前目录。有些命令可用 URL 代替 PATH。

  -r 参数大多数命令都有,缺省 -r BASE。

  欢迎来到 lovickie 的博客 http://www.cnblogs.com/lovickie

  1. 查看

  svn help CMD    # 查看 svn CMD 的帮助,注意 CMD 不含 -xx 之类的参数。

  svn info PATH    # 查看 PATH 路径的详细信息(URL、作者、BASE版本号、修改时间)

  svn log PATH [-v] [-r HEAD/BASE/PREV/版本号]   # 查看 PATH 路径的提交日志,-v 含文件和子文件夹

                                                                          # -r 指定版本,缺省 -r BASE

                                                                    # HEAD 服务器上的最新版

                                                                    # BASE 本地更新或提交的最新版

                                                                         # PREV 前一版,BASE-1

  svn cat PATH/URL [-r 版本]    # 查看内容,-r 指定版本

  svn di PATH [-r 版本A] [-r 版本A:版本B]    # di=diff,查看版本A和本地的区别,或A和B的区别

  svn di PATH/URL -c 版本B    # B必须为数字,查看版本B-1和B的区别

  svn ls PATH [-v]    # ls=list,查看纳入版本的文件和子文件夹列表,-v 含本地最新提交记录

  svn st PATH [-v]    # st=state,查看本地尚未提交的修改,-v 与 svn ls PATH -v 类似

                              # A 增加,D 删除,M 修改,R 替换,C 冲突

                              # I 忽略,? 未纳入,! 异常修改,S 切换

  2. 管理

  svn co URL --username NAME    # co=checkout,检出工作拷贝至本地当前目录

  svn export URL    # 导出至本地当前目录,非工作拷贝,目录中不含.svn

                             # 若当前目录有同名文件夹则失败

  svn import PATH URL -m '提交日志'    # 将本地目录 PATH 导入 URL,PATH 不变为工作拷贝

  svn sw URL    # sw=switch,将本地当前目录切换为 URL 的工作拷贝

  svn lock PATH -m '提交日志'    # 锁定为仅当前用户可修改

  svn unlock PATH    # 解锁,注意不能加 -m 参数

  3. 修改

  svn up PATH [-r 版本]    # up=update,更新至本地,U 被更新,G 合并

                                     # 若 C 冲突,则冲突文件*会被修改,并新增文件 *.rxxxx和*.r.mine

  svn ci PATH -m '提交日志'    # ci=commit,将本地修改提交至服务器,提交日志也可以用双引号

  svn mkdir PATH    # 新建目录 PATH 并纳入版本管理

  svn add PATH    # 将 PATH 新纳入版本管理

  svn del(rm) PATH    # del=delete,rm=remove,将 PATH 移除版本管理并删除

  svn cp OLDPATH NEWPATH    # cp=copy,复制

  svn mv OLDPATH NEWPATH    # mv=move,移动

  svn revert PATH    # 撤销本地修改(但被删除的目录无法恢复)

  svn resolved PATH    # 标记冲突已解决(并非解决冲突文件*,而是删除*.rxxxx和*.r.mine)

  4. 设置忽略属性

  svn propset svn:ignore "FILE" PATH    # 将 PATH 目录中的 FILE 设置为忽略

                                                            # 多个 FILE 用回车区分,不能省略 PATH

  svn propedit svn:ignore PATH    # 编辑 PATH 目录中的忽略列表

                                                    # 之前需 export SVN_EDITOR=/usr/bin/vim

  svn pget svn:ignore    # 读取当前目录的忽略列表

  svn plist    # 查看当前目录的属性,如果设置了忽略则显示 svn:ignore

  欢迎来到 lovickie 的博客 http://www.cnblogs.com/lovickie

  • svn 命令行使用例子

  假设 http://path 为服务器原有目录。

  欢迎来到 lovickie 的博客 http://www.cnblogs.com/lovickie

  1. 检出工作拷贝 path

  svn co http://path --username lovickie    # 检出工作拷贝至本地当前目录

  cd path    # 应 cd path的最子目录,下同

  svn info

  svn log -v -r HEAD

  svn ls -v

  2. 创建目录 path/newdir

  2.1 创建目录方法一:直接操作服务器目录

  svn mkdir http://path/newdir -m '创建目录'    # 直接在服务器上创建目录

  cd path

  svn up .    # 更新至本地

  2.2 创建目录方法二:在本地工作拷贝上操作后提交至服务器

  cd path

  svn mkdir newdir    # 也可以 mkdir newdir 然后 svn add newdir

  svn st    # 显示 A newdir

  svn ci newdir -m '创建目录'    # 提交修改

  svn st    # 无显示,因为本地所有修改均已提交

  svn st -v    # 显示 A newdir

  svn log -v -r HEAD    # 显示 A newdir,'创建目录'

  3. 删除目录 path/newdir/dir1

  3.1 删除目录的准备工作:创建目录 path/newdir/dir1 和 path/newdir/dir1/a.c

  cd path/newdir

  mkdir dir1

  vim dir1/a.c    # 保存退出,下同

  svn add dir1    # 显示 A dir1,A dir1/a.c

  svn ci -m '创建待删除目录dir1和文件a.c'

  3.2 删除目录方法一:直接操作服务器目录

  svn del http://path/newdir/dir1 -m '删除dir1'    # 直接在服务器上删除目录

  cd path/newdir

  svn up    # 更新至本地

  3.3 删除目录方法二

  svn rm dir1

  svn st    # 显示 D dir1,D dir1/a.c

  svn ci -m '删除dir1'    # 提交修改

  svn st    # 无显示

  svn st -v

  svn log -v -r HEAD

  svn up    # 将删除目录信息更新至本地,重要!

  svn st -v    # 显示 D dir1,D dir1/a.c

  svn log -v -r HEAD    # 显示 D dir1,D dir1/a.c,'删除dir1'

  3.4 在删除目录后 svn up 的作用不仅仅是让状态刷成最新版本,而且能避免“莫名其妙”的提交失败

  cd path/newdir

  svn mkdir dir2

  svn ci -m '新建dir2'

  pushd dir2

  vim b.c

  svn add b.c

  svn ci -m '新增b.c'

  popd

  svn del dir2

  svn ci -m '删除dir2'    # 报错

  svn up

  svn ci -m '删除dir2'    # 成功提交

  4. 复制目录 path/newdir/dir3,移动目录 path/newdir/dir4

  4.1 复制目录的准备工作:创建目录 path/newdir/dir3 和 path/newdir/dir3/c.c

  cd path/newdir

  svn mkdir dir3

  vim dir3/c.c

  svn ci -m '创建目录dir3和文件c.c'

  4.2 复制与移动目录

  cd path/newdir

  svn cp dir3 dir4    # 将 dir3 复制到 dir4

  svn mv dir4 dir5    # 失败,除非先提交,注意 --force 也不行

  svn ci -m '复制dir3到dir4'

  svn mv dir4 dir5    # 成功将 dir4 移动到 dir5

  svn del dir5    # 失败,除非先提交

  svn del dir5 --force    # 成功删除 dir5

  svn ci -m '变相删除了dir4'

  5. 撤销本地修改 path/newdir/dir3

  5.1 撤销修改的准备工作:假设 path/newdir/dir3/c.c 已建立并提交

  svn ls path/newdir/dir3/c.c

  5.2 撤销文件修改 dir3/c.c

  cd path/newdir

  vim dir3/c.c    # 随便做些修改

  svn st    # 显示 M dir3/c.c

  svn revert    # 失败,参数不完整

  svn revert .    # 成功,但操作对象是目录.而非文件dir3/c.c

  svn st    # 仍显示 M dir3/c.c

  svn revert dir3/c.c    # 成功撤销修改 dir3/c.c

  svn st    # 无显示

  5.3 撤销文件删除 dir3/c.c

  cd path/newdir

  rm -f dir3/c.c

  svn st    # 因为未采用 svn rm,显示 ! dir3/c.c

  svn revert dir3/c.c    # 成功撤销删除 dir3/c.c

  svn st    # 无显示

  5.4 撤销目录删除 dir3

  cd path/newdir

  rm -rf dir3

  svn st    # 显示 ! dir3

  svn revert dir3    # 失败,删除目录无法用 revert 恢复

  svn up    # 从服务器更新可恢复被删除的一切目录和文件

  欢迎来到 lovickie 的博客 http://www.cnblogs.com/lovickie

  6. 解决冲突 path/newdir/dir3/c.c

  6.1 解决冲突的准备工作:假设 path/newdir/dir3/c.c 已建立并提交

  svn ls path/newdir/dir3/c.c

  6.2 解决别处提交删除导致的冲突

  cd 一个新的本地目录    # 注意该目录下不能有 dir3

  svn co http://path/newdir/dir3

  svn del dir3/c.c

  svn ci -m '在别处删除dir3/c.c'

  cd path/newdir/dir3

  vim c.c    # 随便做些修改

  svn ci -m '不知道c.c已被别处删除,尝试提交对c.c的修改'    # 失败

  svn log -v -r HEAD    # 显示 D c.c,'在别处删除dir3/c.c'

  svn up

  svn st    # 显示 ? c.c,即 c.c 未纳入版本管理

  svn add c.c    # 解决冲突:重新添加 c.c,气死另一位提交者

  svn ci -m '喂不要再删除c.c了'    # 若仍失败说明又有人抢先提交了

  6.3 解决别处提交修改导致的冲突

  cd 一个新的本地目录    # 注意该目录下不能有 dir3

  svn co http://path/newdir/dir3

  vim dir3/c.c    # 修改如下,新增一行:printf ("别处修改\n");

#include <stdio.h>
int main ()
{
printf ("别处修改\n");
return ;
}

  svn ci -m '在别处修改dir3/c.c'

  svn info    # 显示版本号2001

  cd path/newdir/dir3

  svn info    # 显示版本号2000

  vim c.c    # 修改如下,新增两行:printf ("本处修改"); printf ("\n");

#include <stdio.h>
int main ()
{
printf ("本处修改");
printf ("\n");
return ;
}

  svn ci -m '不知道c.c已被别处修改,尝试提交对c.c的修改'    # 失败

  svn log -v -r HEAD    # 显示 M c.c,'在别处修改dir3/c.c',注意缺省是 -r BASE

  svn cat c.c -r BASE    # 查看 BASE=2000版内容

  svn cat c.c -r HEAD    # 查看 HEAD=2001版内容

  svn di -r BASE:HEAD    # 2000:2001,显示 BASE 与 HEAD 的差别

  svn di [-r BASE]    # 显示 BASE=2000版与本地修改的差别

  svn di -r HEAD    # 显示 HEAD=2001版与本地修改的差别,如下

Index: c.c
=========================
--- c.c (修订版 2001)
+++ c.c (工作拷贝)
@@ -, +, @@
{
-printf ("别处修改\n");
+printf ("本处修改");
+printf ("\n");
}

  svn up

  svn st    # 显示 ? c.c.r2000,本地更新或提交的最新版BASE

               #    ? c.c.r2001,服务器上的最新版HEAD,printf ("别处修改\n");

               #    ? c.c.mine,本地修改,printf ("本处修改"); printf ("\n");

               #    C c.c,冲突文件,若为U更新、G合并则不用解决,c.c 内容如下

#include <stdio.h>
int main ()
{
<<<<<<< .mine
printf ("本处修改");
printf ("\n");
=======
printf ("别处修改\n");
>>>>>>> .r2001
return ;
}

  vim c.c    # 手动修改解决冲突

  svn resolved c.c    # 删除 c.c.*,标记冲突已解决

  svn st    # 显示 M c.c

  svn ci -m '解决c.c的修改冲突'    # 生成版本2002

  6.4 详解 svn di PATH -r A:B 或 -r A(B为本地尚未提交)或 -c B(A=B-1)的输出格式

Index: 有差别的文件 c.c
=========================
--- c.c (修订版 A)
+++ c.c (修订版 B)
@@ -, +, @@ # 以下显示版本A的3~5行,版本B的3~6行
版本AB的相同内容
-版本A的独有内容
+版本B的独有内容
版本AB的相同内容

  注意:当 svn di [-r BASE] 时,显示 --- (修订版 2000),+++ (工作拷贝);

     当 svn di -r BASE:HEAD 时,显示 --- (工作拷贝),+++ (修订版 2001)。

     “工作拷贝”在上面两处的含义不同!

  欢迎来到 lovickie 的博客 http://www.cnblogs.com/lovickie

  7. 加锁与解锁 path/newdir/dir3/c.c

  7.1 加锁的准备工作:假设 path/newdir/dir3/c.c 已建立并提交

  svn ls path/newdir/dir3/c.c

  7.2 加锁与解锁

  cd path/newdir

  svn lock dir3/c.c -m '用户lovickie锁定c.c'    # 加锁

  svn unlock dir3/c.c    # 解锁,加 -m 则失败

  8. 导出与导入

  8.1 导出 path/newdir

  cd 一个新的本地目录    # 注意该目录下不能有 newdir

  svn export http://path/newdir [-r HEAD]    # 当前目录生成的 newdir 中不含.svn,非工作拷贝

  8.2 导入 path/newdir/dir6/d.c

  cd 一个新的本地目录

  mkdir dir6

  vim dir6/d.c

  svn import dir6 http://path/newdir -m '导入dir6中的内容'    # 即只导入了 d.c

  8.3 导入 path/newdir/dir7

  cd 一个新的本地目录

  mkdir dir7

  vim dir7/e.c

  svn import dir7 http://path/newdir/dir7 -m '导入dir7'    # 即导入了 dir7 和 dir7/e.c

  8.4 检验导入结果

  cd path/newdir

  svn up    # 显示 A d.c,A dir7,A dir7/e.c

  9 切换工作拷贝 path/newdir/dir8

  9.1 切换工作拷贝的准备工作:假设 path/newdir/dir7/e.c 已建立并提交

  svn ls path/newdir/dir7/e.c

  9.2 切换工作拷贝

  cd path/newdir

  mkdir dir8

  vim dir8/f.c

  svn add dir8

  svn ci -m '新建dir8'

  cd dir8

  svn sw http://path/newdir/dir7    # 切换本目录为 dir7 的工作拷贝

  svn ls    # 显示 e.c

  svn st path/newdir    # 显示 S dir8

  9.3 恢复原工作拷贝(不能revert)

  cd path/newdir

  rm -rf dir8

  svn up

  svn ls dir8    # 显示 f.c

  欢迎来到 lovickie 的博客 http://www.cnblogs.com/lovickie

  10 设置忽略 path/newdir/dir3

  10.1 设置忽略的准备工作:假设 path/newdir/dir3 已建立并提交

  svn ls path/newdir/dir3

  cd path/newdir/dir3

  vim a.out

  vim a.o

  vim b.obj

  svn st    # 显示 ? a.out,? a.o,? b.obj

  10.2 设置忽略文件

  cd path/newdir/dir3

  svn propset svn:ignore "a.out

  > *.o

  > *.obj" ./    # 注意不能省略最后的./或.,多个忽略文件用回车分隔(>是自动生成的提示符)

  svn st    # 无显示,表明忽略列表设置成功

  export SVN_EDITOR=/usr/bin/vim    # 否则无法执行 svn propedit

  svn propedit svn:ignore ./    # 编辑当前目录的忽略列表,保存退出后生效

  svn pget svn:ignore    # 读取当前目录的忽略列表,显示 a.out  *.o  *.obj

  svn plist    # 显示 svn:ignore

   合并(svn merge)

  该功能太浪,不建议在未完全掌握时使用。

  欢迎来到 lovickie 的博客 http://www.cnblogs.com/lovickie

  • 结语

  有什么地方写得不对的或者描述得不清楚的,欢迎留言指出,我会改正和改进。