SVN简明课程

Reference: http://www.cnblogs.com/wangkangluo1/archive/2011/08/11/2135312.html

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/
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服务器的最新修订版更新本地工作拷贝。

多人合作时：

更新要经常频繁的做，尽量让问题及早暴露，便于处理。
提交代码前要更新，否则容易产生版本冲突。

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 up

svn 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_name

svn commit -m "xxxx"

或者：

svn cp path/file_name newpath/new_file_name

svn 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默认不对文件加锁。

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

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

解决方法（人工仲裁）：

放弃改动；
坚持你的改动，找到.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

提交。

5. 未讲到的内容

svn备份
subversion属性
与apache集成的配置和使用

原文链接：http://www.iteye.com/topic/28013

一直以来用svn只是当作cvs，也从来没有仔细看过文档，直到今天用到，才去翻看svn book文档，惭愧

需求一：
有一个客户想对产品做定制，但是我们并不想修改原有的svn中trunk的代码。

方法：
用svn建立一个新的branches，从这个branche做为一个新的起点来开发

svn copy svn://server/trunk svn://server/branches/ep -m "init ep"

Tip:
如果你的svn中以前没有branches这个的目录，只有trunk这个，你可以用

svn mkdir branches

新建个目录

需求二：
产品开发已经基本完成，并且通过很严格的测试，这时候我们就想发布给客户使用，发布我们的1.0版本

svn copy svn://server/trunk svn://server/tags/release-1.0 -m "1.0 released"

咦，这个和branches有什么区别，好像啥区别也没有？
是的，branches和tags是一样的，都是目录，只是我们不会对这个release-1.0的tag做修改了，不再提交了，如果提交那么就是branches

需求三：
有一天，突然在trunk下的core中发现一个致命的bug,那么所有的branches一定也一样了，该怎么办？

svn -r 148:149 merge svn://server/trunk branches/ep

其中148和149是两次修改的版本号。

其他的呢？看文档

原文地址：http://blog.chinaunix.net/space.php?uid=22976768&do=blog&id=1640924

windows下的TortoiseSVN是资源管理器的一个插件，以覆盖图标表示文件状态，几乎所以命令都有图形界面支持，比较好用，这里就不多说。主要说说linux下svn的使用，因为linux下大部分的操作都是通过命令行来进行，所以必须得掌握linux下svn的常用指令。当然linux下也有模仿TortoiseSVN的linux X程序，例如RabbitVCS,模仿程度很高，但很容易拖慢X，因此不推荐。

(如果是第一次提交文件，很可能会出现“svn：'.'不是工作副本”，即当前目录不是工作副本，这个时候需要用到import：

eg：svn import . url)

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文件)
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：被锁定】M状态一般比较多
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 是上一版本,也可以写具体版本号,这样输出结果是可以提交的)