笔记之SubVersion

jackxiang 2008-8-20 18:38 | |
笔记之SubVersion
一、获取与安装
SubVersion(以下简称SVN)是一款开源的版本控制系统,与著名的CVS类似,并大有取代之势,当前版本1.4.3,可以从http://subversion.tigris.org/project_packages.html下载。我下载的是Windows版,下载文件svn-1.4.3-setup.exe后,双击,按照提示进行安装。安装时,安装程序会自动将环境配置好。
二、常用操作
创建SVN版本库的命令:
svnadmin create e:\svn
SVN会在e:\svn文件夹下创建一个版本库,版本库用来保存提交到SVN中的文件,并记录相应版本信息。如果e:\svn文件夹没有创建,SVN会自动创建。

导入与拆出文件。要将文件夹导入SVN版本库,可以执行命令:
svn import F:\project1 file:///e:/svn/project -m "firstProject"
其中-m是import子命令的参数,用于记录操作日志,当前步骤的操作日志为“firstProject”,其它svn命令如无特殊说明,-m参数也是同样含义。此时SVN会将F:\project1文件夹导入到刚刚创建的SVN版本库file:///e:/svn中的project目录下。下面执行命令:
svn checkout file:///e:/svn/project F:\project1
此时SVN版本库就被关联到F:\project1文件夹了。
不过将svn checkout操作简单地说成关联是不正确的,这一步操作应当称为拆出文件,其作用是将保存在SVN版本库中的文件取出,存放到指定文件夹下以供编辑。例如建立一个文件夹F:\project2,然后执行命令:
svn checkout file:///e:/svn/project F:\project2
此时SVN版本库也会被取到F:\project2中。下面将利用F:\project1和F:\project2文件夹来模拟两个用户的操作。

添加文件和文件夹。下面在F:\project1文件夹下新建文件1.txt,这是一个文本文件,然后在命令行中定位到该文件夹下,执行命令:
svn add 1.txt
svn commit -m ""
此时1.txt文件就会被添加到SVN版本库中了。这里注意,commit子命令是用来向SVN版本库提交修改内容的,以后每次文件有所变化都应用该命令向SVN执行提交。
与CVS不同,在SVN中是不区分文本文件和二进制文件的,例如在F:\project1文件夹下新建文件2.doc,然后执行命令:
svn add 2.doc
svn commit -m ""
跟之前的命令一样,此时2.doc也被添加到SVN版本库中了。
下面在F:\project1文件夹下再新建一个文件夹dir,然后执行命令:
svn add dir
svn commit -m ""
此时文件夹dir同样会被添加到SVN版本库中。

更新文件和文件夹。下面在命令行中定位到F:\project2文件夹下,此时的F:\project2是个空文件夹,没有任何内容。执行命令:
svn update
文件1.txt、2.doc和文件夹dir都被下载到F:\project2中了。其实svn update的作用是更新本地文件,记得以后每次修改文件之前,都执行一次该命令。

提交与更新文件。下面打开F:\project1中的1.txt文件,修改、保存并关闭,然后在命令中定位到该文件夹下,执行命令:
svn commit -m "edit 1.txt"
此时对1.txt所作的修改会被提交到SVN版本库中。如果想放弃修改,则可以在提交之前执行命令svn revert 1.txt,此时1.txt会被恢复成修改之前的内容。
下面再打开F:\project2中的1.txt文件,发现内容没有改变,关闭,在命令行中定位到该文件夹下,执行命令:
svn update
再次打开F:\project2\1.txt文件,会发现内容已经发生了变化,与F:\project1\1.txt文件一样。

处置修改冲突。下面分别修改F:\project1\1.txt和F:\project2\1.txt文件,注意保证两者内容的不一致,然后首先用svn commit -m ""提交F:\project1\1.txt,再提交F:\project2\1.txt,此时SVN会提示有冲突。这是因为我们对同一个文件作了不同的修改所致,这种情况在日常使用中会经常发生。要解决这个问题,请先在命令行中定位到F:\project2下,执行命令svn update,此时SVN将更新1.txt文件,把有冲突的部分以格式:
<<<<<<< .mine
F:\project2\1.txt文件冲突部分内容
=======
F:\project1\1.txt文件冲突部分内容
>>>>>>> .r4
标记出来,并生成1.txt.mine、1.txt.r3和1.txt.r4文件,以分别记录更新之前的F:\project2\1.txt、修改之前的F:\project2\1.txt和新近修改的F:\project1\1.txt。与CVS不同,SVN提供了三种解决问题的办法:第一种办法需要重新修改F:\project2\1.txt,然后执行命令:
svn resolved 1.txt
svn commit -m ""
其中resolved子命令用来告诉SVN指定文件的冲突已经解决。至此问题解决。关于1.txt.mine、1.txt.r3和1.txt.r4等文件,SVN会在执行svn resolved 1.txt命令时自动删除的。
第二种办法是在SVN自动生成的1.txt.mine、1.txt.r3和1.txt.r4等文件中进行选择,用其中之一直接覆盖1.txt文件,然后执行命令:
svn resolved 1.txt
svn commit -m ""
最后一种办法是放弃修改,或者称为恢复,即执行命令svn revert,此时F:\project2\1.txt变得与F:\project1\1.txt文件内容相同。注意,执行revert子命令时是不需要再执行commit子命令的。

文件和文件夹的查看与比较。先在命令行中定位到F:\project1下,执行svn update命令,然后陆续执行以下命令并观察其效果:
svn status -v 查看版本库中所有文件和文件夹的状态
svn status -v 1.txt 查看1.txt文件的状态
svn status -v dir 查看dir文件夹的状态
svn log 查看版本库中所有文件和文件夹的日志
svn log 1.txt 查看1.txt文件的日志
svn log dir 查看dir文件夹的日志
svn diff 1.txt 若保存在本地的1.txt文件被修改,则与保存在.svn文件夹中的原始拷贝比较差异
svn diff -r4 1.txt 用保存在本地的1.txt文件与保存在SVN版本库中的1.txt文件的特定版本比较差异
svn diff -r4:5 1.txt 比较SVN版本库中1.txt文件两个版本间的差异
svn cat -r4 1.txt 查看1.txt特定版本的内容
svn list[ file:///e:/svn] 查看仓库中的目录内容

文件和文件夹的删除。先在命令行中定位到F:\project1下,然后执行命令:
svn delete 2.doc
svn commit -m ""
此时F:\project1\2.doc文件就被从SVN版本库中删除了。如果想删除文件夹,以F:\project1\dir为例,可以执行命令:
svn delete dir
svn commit -m ""
与删除文件的操作一样。

文件和文件夹的恢复。在SVN中,文件的恢复可以分为两种情况,一种是删除文件但未提交,以F:\project1\1.txt文件为例,先在命令行中定位到F:\project1下,然后执行命令svn delete 1.txt,此时使用命令svn revert 1.txt,1.txt就被恢复了。其实revert子命令是用来放弃修改的,之前在“处置修改冲突”部分也曾提到过该命令。
另一种是删除文件且已提交,以之前删除的F:\project1\2.doc文件为例,执行命令:
svn copy -r 7 file:///e:/svn/project/2.doc 2.doc
svn commit -m ""
其中-r参数的值6是2.doc删除前的最后一个版本,此时F:\project1文件夹下便多了个2.doc文件。不过在SVN中,恢复文件的办法不止一途,还可以使用命令:
svn merge -r 10:7 file:///e:/svn/project
svn commit -m ""
此时dir文件夹也被恢复到F:\project1下了。与copy子命令相比,merge子命令是对文件进行回滚,而copy子命令则是对文件进行复制。关于这两个命令,下边会有更详细的介绍。不过现在我们可以发现一件事,即在SVN中文件和文件夹的处理方式是一样的,或者说在SVN中文件夹也是一种文件。

文件与文件夹的重命名与移动。先在命令行中定位到F:\project1下,执行命令:
svn move 2.doc 3.doc
svn commit -m ""
此时2.doc就被改名为3.doc了。下面再执行命令:
svn move 3.doc dir/3.doc
svn commit -m ""
此时3.doc又被移动到dir下了。由于在SVN中文件夹也被视为一种文件,处理方式与文件一样,因此这里就不再赘述了。

分支(branch)。假定软件K的发行版1.0已完成,而你正在继续开发下一版本,并计划在一段时间后发行版本1.1。可是不久你的客户就开始抱怨说K 1.0有问题,于是你检出了1.0的发行版,找到了这个错误。但是,当前代码的版本正处在一个不稳的状态,并且在一段时间之后才有希望稳定下来,这样就没法基于最新源代码去发行一个修复错误的版本了。这种情况下可以去为所有构成K 1.0发行版的文件创建版本树的一个分支。然后你可以修改这分支而不影响到主干。当修订完成时,你可以选定是否要把它同主干合并或继续保留在这个分支里。

创建分支。先在命令行中定位到F:\project1下,执行命令:
svn copy F:\project1\dir F:\project1\dir2
svn commit -m ""
此时SVN会在本地创建F:\project1\dir的副本F:\project1\dir2,两者内容一致,然后提交内容到SVN版本库中以为F:\project1\dir创建分支。这种作法与之前恢复已提交的删除文件时所使用的copy子命令类似,两者都是在本地创建指定文件或文件夹的副本,然后提交到版本库中,只是后者是为SVN版本库中的内容创建副本。其实SubVersion中所谓的分支,就是特定文件或文件夹的副本,与以往的版本管理工具相比,SubVersion中分支不是逻辑存在的,而是物理存在的。
此外,SVN提供了更简便的方式来建立分支:
svn copy file:///e:/svn/project file:///e:/svn/new_project -m ""

svn copy F:\YPJCCK\VersionControl\svn\project1\ file:///e:/svn/new_project -m ""
两者都会在SVN版本库中创建分支并直接提交,其差异在于前者是以SVN版本库中的内容为基础,而后者是以本地内容为基础。
此外,SubVersion中还有一个概念,标签(tag)。标签是一个文件在一段时间里的快照,在SubVersion中每次提交的修订版本都是一个快照。SubVersion中标签已与分支的概念相同。

获取分支。先在命令行中定位到F:\project2下,执行命令:
svn update dir2
此时dir2会被下载到F:\project2中。如果想下载之前的版本也可以利用该命令,例如:
svn update -r 10
此外,我们还可以转换工作拷贝对应的分支,在F:\project2下执行命令:
svn switch file:///e:/svn/new_project
然后执行命令svn update,此时F:\project2就被更新成new_project分支了。

在不同分支下修改文件。下面分别修改F:\project1\1.txt和F:\project2\1.txt文件,注意保证两者内容的不一致,然后使用svn commit -m ""进行提交。这两个文件均会被正确提交,而SVN也并未因为两者内容不一致提示版本冲突,只是提示新增了两个版本,这说明之前创建分支已经成功。

合并分支。在命令行中定位到F:\project1下,执行命令:
svn merge -r 17:Head file:///e:/svn/new_project
咦,这条命令看起来似乎有点眼熟,没错,前边介绍文件恢复时曾介绍过,不过当时是从高版本回退到低版本,而现在则是将分支合并到主干。其实merge子命令的真正作用是比较两个指定版本的区别,然后将结果应用到当前工作目录。这里Head代表最新版本,17则是之前修改分支时产生的版本。由于之前分别修改了F:\project1\1.txt和F:\project2\1.txt,并且刻意保证了两者内容的不同,因此在将new_project分支合并到主分支时,SVN会提示冲突。关于冲突的处置,与之前介绍的处置修改冲突方法一样,这里不再赘述。修改过1.txt文件后,执行命令:
svn resolved 1.txt
svn commit -m ""
合并完成。
此外,merge子命令还有四种形式(按照帮助的说法应该是两种):
svn merge F:\project1@16 F:\project2@18(本地副本的比较)
svn merge file:///e:/svn/project@16 file:///e:/svn/new_project@18(版本库内容的比较)
svn merge F:\project1@16 file:///e:/svn/new_project@18(本地副本与版本库内容的比较)
svn merge file:///e:/svn/project@16 F:\project2@18(版本库内容与本地副本的比较)
其作用也是将指定版本比较后,把结果应用到当前工作目录。这里@之后的数值代表版本,其中版本库路径后是可以省略的,缺省为Head,本地副本则必须指定。

属性操作。属性用来存放特别信息,可以为文件保存更多信息,是对工作拷贝的有益补充。
下面在命令行中定位到F:\project1下,执行命令:
svn propset test1 'test' 1.txt
svn propset test2 -F 2.txt 1.txt
前者为1.txt文件设置属性test1,属性值为test;后者为1.txt文件设置属性test2,并指定本地已存在文件2.txt的内容作为属性值。注意,通过-F参数,可以为属性指定任何文件作为值,包括二进制文件。
下面执行命令:
svn proplist 1.txt
svn propget test1 1.txt
前者用于查看1.txt文件有哪些属性;后者用于查看test1属性的值。
执行命令:
svn propedit test1 1.txt --editor-cmd notepad
指定使用notepad(Windows中的记事本,别告诉我你不知道)编辑1.txt文件的test1属性。修改后,关闭记事本即可。
现在我不想要test2属性了,执行命令:
svn propdel test2 1.txt
再次使用svn proplist 1.txt命令查看,test2属性已删除。
注意,经过以上一系列操作,1.txt文件已经被修改,因此需要使用svn commit -m ""命令进行提交。
此外,SVN自身也提供了一些属性,这些属性以svn开头,例如svn:executable、svn:mime-type等。关于这些属性,请参考其他文档,这里不介绍。

导出。在命令行中执行命令:
svn export file:///E:/svn/project F:\project

svn export F:\project1 F:\project
此时版本库或工作副本中的内容都被导出到F:\project文件夹中。注意,F:\project会自动生成,并且该文件夹中的内容比较干净,不包含版本控制信息。

生成补丁。在命令行中定位到F:\project1下,执行以下任意一条命令:
svn diff -r10:19 1.txt > test.diff(在1.txt的两个指定版本间比较)
svn diff -r10 1.txt > test.diff(在1.txt的当前版本与指定版本间比较)
svn diff -r10 > test.diff(在当前模块的当前版本与指定版本间比较)
svn diff file:///e:/svn/project file:///e:/svn/new_project > test.diff(在两个路径间比较)
会生成输出信息到文件test.diff中。这些版本间的差异信息被称为补丁,而test.diff文件则称为补丁文件。注意,当不写“> test.diff”时,例如svn diff -r10:19 1.txt,信息会直接输出到屏幕。
三、子命令别名
在SVN中,一些子命令是有别名的,通过别名可以简化操作,例如commit子命令的别名为ci,这样就可以将命令:
svn commit -m ""
简化为:
svn ci -m ""
下面列出了前面用到的一些子命令的别名:
checkout:co
commit:ci
copy:cp
delete:del,remove,rm
diff:di
help:?,h
list:ls
move:mv,rename,ren
propdel:pdel,pd
propedit:pedit,pe
propget:pget,pg
proplist:plist,pl
propset:pset,ps
status:stat,st
switch:sw
update:up
四、update子命令的输出
在执行update或commit子命令的过程中,会看到一些标志性的字母,那么这些字母表示些什么呢?
A 在工作副本中添加文件并将这一操作更新到CVS仓库
D 在工作副本中删除文件并将这一操作更新到CVS仓库
U 更新工作副本中不存在或者没有修改过的文件
C 有冲突
G 合并成功
注意,SVN的update子命令可能会有两列输出,两列输出时第一列表示的是文件本身,第二列表示的是文件属性。 





作者:jackxiang@向东博客 专注WEB应用 构架之美 --- 构架之美,在于尽态极妍 | 应用之美,在于药到病除
地址:https://jackxiang.com/post/1199/
版权所有。转载时必须以链接形式注明作者和原始出处及本声明!

评论列表
发表评论

昵称

网址

电邮

打开HTML 打开UBB 打开表情 隐藏 记住我 [登入] [注册]