svn 常用指令
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。
资源:
-
subversion中文站:http://www.subversion.org.cn/
-
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
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 是上一版本,也可以写具体版本号,这样输出结果是可以提交的)
完