SVN (subversion) 简明实用课程

1. 版本控制介绍

 

1.1. 什么是版本控制

版本控制系统用于保存编写开发应用程序时的文档的各个修订版（revision）。

版本控制也称作Revision Control System(RCS)。

名词解释：

• 修订版（revision）：可以认为是某个文件在其生命周期内各个保存的快照，每个快照和一个时间区间对应。
• 版本库（Repository）：存放修订版的数据库
• 本地工作拷贝（Local working copy）：修订版在本地的副本
• 版本的检入（Check in）：本地副本提交到服务器的版本库
• 检出（Check out）：从服务器的版本库中取出修订版成为本地副本
• 版本号的来源：有两种策略，基于文件的计数和基于仓库的计数，subversion使用后者
• 标签（Tags）：为版本加一个名字，便于检出
• 分支（Branches）：修订版打分支，以后可以平行修改，互不干扰
• 合并（Merging）：将分支的修订版合并为一个新的修订版
• 锁（Locking）：为修订版枷锁
• 冲突（Conflict）：并发版本控制时防止修订版混乱的错误机制

 

1.2. 使用版本控制的好处

对团队和个人都有好处：

• 为团队提供了所有项目文档的回退按钮；
• 支持多个开发人员在可控的方式下为相同的代码工作；
• 版本控制系统保存了文档在过去的各个改动，便于查找是谁，在何时，因为什么修改了文档；
• 支持在文档的主线上同时有多个版本；
• 支持查询在某个时点上项目各个文档的状态，可用于研究生产效率等，也可用于对以前的软件发行版的再发行。

 

1.3. 常见的版本控制系统

• VSS：Visual Source Save，微软公司的版本控制器软件，http://msdn2.microsoft.com/zh-cn/vstudio/aa718670.aspx

• CVS：Concurrent Versions System，开源免费，http://www.nongnu.org/cvs/

• Subversion，开源免费，http://subversion.tigris.org/

• xistent" style="color: #336699; text-decoration: none;" href="http://localhost:9922/ClearCase">ClearCase，IBM公司，http://www-306.ibm.com/software/awdtools/clearcase/

 

2. Subversion介绍

Subversion是新一代的版本控制工具，正逐步替代CVS。

资源：

• 官方网址：http://subversion.tigris.org/

• subversion中文站：http://www.subversion.org.cn/

• 中文手册：http://www.subversion.org.cn/svnbook/

• subversion与cvs的对比：http://www.uml.org.cn/pzgl/200705251.asp

 

3. Subversion基本使用

 

3.1. Subversion安装

Subversion是典型的C/S模式应用程序。

Windows环境下的安装包：http://subversion.tigris.org/files/documents/15/41687/svn-1.4.6-setup.exe

安装过程很简单，图形界面，默认选择即可。

输入svn命令查看安装是否成功：

 

svn --version

svn命令是subversion程序的客户端

svnserver命令可以启动svn服务器，用于搭建简易的svn服务器环境

见：http://www.easymorse.com/bbs/viewthread.php?tid=95&extra=page%3D1

 

3.2. 服务器端

以下是搭建简易的服务器端环境的做法，正式一般配合apache通过http访问。

 

3.2.1. 创建版本库

创建服务器端版本库，相当于DBMS创建数据库示例。

命令行：

 

svnadmin create file_path/repo_name

 

3.2.2. 启动服务器

 

svnserve.exe -d  -r file_path

• -d 后台执行
• -r 版本库的根目录

访问该版本库的url：svn//localhost/repo_name

 

3.3. 客户端

 

3.3.1. 初始导入（import）

通过命令行导入：

 

svn import -m "init import" http://10.0.0.6/svn/teaching/

该命令可将当前路径下文件导入到版本库中。

 

3.3.2. 检出（checkout）

通过命令行检入：

 

svn co http://hibernate3demo.googlecode.com/svn/tags/helloworld_r1

或者：

 

svn checkout http://hibernate3demo.googlecode.com/svn/tags/helloworld_r1

或者：通过第三方图形工具的检出，比如tortoiseSVN（http://tortoisesvn.tigris.org/）

将svn服务器的最新修订版下载到本地成为本地工作拷贝。

 

3.3.3. 保持更新（update）

命令行：

 

svn update

或者

 

svn up

或者通过tortoiseSVN

或者通过eclipse插件，subclipse（http://subclipse.tigris.org/），在线安装：http://subclipse.tigris.org/update_1.2.x/

用svn服务器的最新修订版更新本地工作拷贝。

多人合作时：

• 更新要经常频繁的做，尽量让问题及早暴露，便于处理。
• 提交代码前要更新，否则容易产生版本冲突。这个有亲身的体会： 例如用户A和用于B

      修改了各自副本上的文件,A修改了文件File先上传了，B也修改了文件File，结果B未Update直接Commit，

      结果不管他们修改的是否是File文件的同一个地方，都会出现提交失败的现象。所以在进行Commit之前一定先要

      更 新本地副本。用户A如果和用户B修改的不是同一个文件，更新时不会出现提交失败的提示，但是建议提交前也要

      先Update一下,养成良好的习惯.

 

3.3.4. 添加（add）

命令行：

 

svn add file_path

或者通过tortoiseSVN，eclipse插件。

告知svn服务器，添加目录和/或文件到服务器上，这个操作类似SQL的insert，但是并没有真的操作，直到commit。

 

3.3.5. 提交改动

相当于通用概念：检入（checkin）。

命令行：

 

svn commit

或者：

 

svn ci

或者通过tortoiseSVN，eclipse插件。

提交本地工作拷贝的所有改动，而且是原子性的。

要求：一般要注明修改的原因

 

svn ci -m "修改bug #224"

要求：提交之前要做更新

 

svn upsvn ci -m "修改bug #224"

 

3.3.6. 还原改动

对应提交(commit)，要有类似回滚（rollback）的操作。

 

svn revert

或者通过tortoiseSVN，eclipse插件。

这个操作对开发人员十分有用，在改动被人很多代码后可以“一键恢复”。

 

3.3.7. “还原”已提交的改动

revert只适合未提交的情况。

如果已经提交，发现问题，要回退到之前的修订版。

首先需要：

 

svn up

让本地工作拷贝更新到最新状态。

然后：

 

svn log your_file_path

查看文件日志，这时候提交时填写的说明信息就派上用场了。

查看两个修订版之间的不同：

 

svn diff -r 旧修订版序号:新修订版序号 your_file_path

或者通过tortoiseSVN，eclipse插件。

决定用哪个旧的修订版号后，用旧的修订版号文件覆盖新的修订版号文件。

 

svn merge -r 新修订版序号:旧修订版序号 your_file_path

还需要：

 

svn commit -m "恢复到某修订版（某修订版作废）"

或者通过tortoiseSVN，eclipse插件。

这个还原是所谓的，不是用旧的版本号替代，而是将旧文件覆盖新文件。

 

3.3.8. 拷贝文件和目录

命令行：

 

svn copy path/file_name newpath/new_file_namesvn commit -m "xxxx"

或者：

 

svn cp path/file_name newpath/new_file_namesvn commit -m "xxxx"

或者：利用windows的资源管理器/unix的cp命令

或者通过tortoiseSVN，eclipse插件。

svn的copy，是很重要的工具，版本分支和标签等概念都通过它实现。

svn的copy，是廉价的拷贝。

 

3.3.9. 重命名目录/文件

命令行：

 

svn move file_name new_file_name

或者：

 

svn mv file_name new_file_name

 

3.3.10. 处理合并冲突

svn默认不对文件加锁。

如果不同人编辑了同一个文件的不同部分，提交前先Update，svn会自动合并。

如果不同人编辑了同一个文件的同一部分，Update时,后提交者会报告合并冲突。

解决方法（人工仲裁）：

• 智能选择      

          如果commit时出现“You have to update your work copy first.”红色警告，说明版本库中的此文件已经被其他人修改了。        请先点“ok”按钮退出。执行update,然后再commit。

          如果修改与update得到的代码不冲突，则自动合并。如果冲突（比如对同一行代码进行了修改），则出现”One or more           files are in a conflicted state.“红色警告，并产生几个文件记录冲突。一般情况下，我们不要直接编辑冲突文件。而按照以       下操作手工解决冲突。

      在资源管理器中，选择commit时冲突的那个文件，鼠标右键菜单选择”Edit conficts”。

      出现界面，分为”Theirs”、”Mine”和”Merged”3部分，表示”别人修改的内容”、 ”我修改的内容”和”合并后的结果”3       部分。我们是要将”别人修改的内容”和”我修改的内容”有取舍地合并起来，形成”合并后的结果”。

     合并一般分为4种情况：

    1、保留”我的修改”,舍弃”别人的修改”。鼠标右键点击Mine框的相应行，点击”Use this text block”。

    2、舍弃”我的修改”,保留”别人的修改”。鼠标右键点击Theirs框的相应行，点击”Use this text block”。

    3、同时保留”我的修改”和”别人的修改”，并将”我的修改” 放在前面。鼠标右键点击Mine框的相应行，点击”Use text block        from mine before theirs”。

    4、同时保留”我的修改”和”别人的修改”，并将”别人的修改”放在前面。鼠标右键点击Mine框的相应行，点击”Use text             block from theirs before mine”。

        合并完成，Ctrl+S存盘，退出。

       然后，在资源管理器中，选择冲突文件，鼠标右键菜单选择”Resolved”,标记冲突已解决。系统会自动删除因冲突而新建的文       件。此时，就可以继续进行commit操作了。

       

       如果修改了工程配置“projec”-Setting，请上传*.opt文件。

       如果添加新的文件，请add新的文件同时，上传*.dsp文件。

       否则不要commit这两个文件。

• 坚持你的改动，找到.mine的文件名，恢复为原文件名，然后执行：

  svn resolved file_name

3.3.11. 删除文件

将本地工作拷贝删除。

命令行：

 

svn delete file_path

或者：

 

svn del file_path

 

4. Subversion高级内容

 

4.1. 文件锁

一般用于二进制内容，因为无法合并。

如果某个文件加锁，其他用户的本地工作拷贝（更新后）将是只读的。

当该用户提交后，其他用户的本地工作拷贝（更新后）才可以写操作。

其他用户可以“撬锁”，然后进行写操作。

高级配置可以配置“撬锁”权限，使不是什么人都可以“撬锁”。

 

4.2. 版本库创建策略

单一的版本库保存一个项目。

单一的版本库保存多个项目。

多个版本库。

 

4.3. 使用标签和分支

在svn中标签和分支都源于copy命令。

3个约定俗成的目录：

• trunk：主干
• branches：分支
• tags：标签

发布分支：

 

svn cp -m "创建用于实现radio标签的分支" https://easymorse-simpletag.googlecode.com/svn/branches/simpletag_select_1 https://easymorse-simpletag.googlecode.com/svn/branches/simpletag_select_2

切换分支：

svn switch https://easymorse-simpletag.googlecode.com/svn/branches/simpletag_select_2

合并分支需要两个步骤：

合并操作

svn merge -r 33:HEAD https://easymorse-simpletag.googlecode.com/svn/branches/simpletag_select_2

或者：

 

svn merge https://easymorse-simpletag.googlecode.com/svn/trunk/simpletag@HEAD https://easymorse-simpletag.googlecode.com/svn/branches/simpletag_select_1@HEAD

提交。

备注:

TortoiseSVN日常使用指南 - 中文SVN技术资料:http://www.svn8.com/SVNSY/20080318/360.html

subversion安装指南:http://www.svn8.com/SVNSY/20090825/8889.html

TortoiseSVN配置服务器:http://www.svn8.com/SVNSY/20080318/358.html
来源:SVN中文技术网

转载自：http://blog.csdn.net/byxdaz/archive/2009/09/25/4593032.aspx