Subversion使用指南(已更新公司最新模板)

1、Subversion使用指南使用指南秘密课程学习目标课程学习目标n 了解了解Subvertion的基本概念和操作的基本概念和操作 秘密课程大纲课程大纲Subversion简介Subversion安装Subversion配置Subversion操作常见问题秘密SubversionnSubversion （简称为SVN）是一个自由/开源的版本控制系统，它系统地管理着文件和目录nSubversion可以通过网络访问它的版本库，从而使用户可以在不同的终端上使用秘密TortoiseSVNnTortoiseSVN（简称为TSVN）是 Subversion的 Windows 扩展nTSVN嵌入 Window

2、s Explorer，可以实现简单的图形化界面操作秘密课程大纲课程大纲Subversion简介Subversion安装Subversion配置Subversion操作常见问题Subversion安装秘密TSVN安装n客户端只需要安装TSVN即可操作SubversionnTSVN安装文件为：scm-svnSVNsetupTortoiseSVN-1.5.4.14259-win32-svn-1.5.3.msi 配套中文补丁为：scm-svnSVNsetupLanguagePack_1.5.4.14259-win32-zh_CN.msin以TortoiseSVN1.4.8版本为例图示安装步骤：秘密TS

3、VN安装步骤-1运行安装文件，Next继续秘密TSVN安装步骤-2选择“I accept ” ， Next继续秘密TSVN安装步骤-3缺省设置，可修改安装路径，Next继续秘密TSVN安装步骤-4Install开始安装秘密TSVN安装步骤-5安装完成，Finish后重启计算机。秘密TSVN安装步骤-6安装中文补丁，Install进行安装。秘密课程大纲课程大纲Subversion简介Subversion安装Subversion配置Subversion操作常见问题Subversion配置秘密TSVN配置-1n右击桌面选择TortoiseSVN Settings，常规设置的语言栏选择“中文(简体)”

4、n选中“将文件日期设置为“最后提交时间”，以便在做检出或更新操作时，系统默认将文件日期设置为库中的最后提交时间，否则使用当前日期n“全局忽略样式”内填入*.db *.bak *.obj等过程文件类型，以后每次进行SVN操作，对扩展名为.db、.bak和.obj等文件就是透明的了，不会对其做任何操作。多个扩展名用空格隔开秘密TSVN配置-2秘密课程大纲课程大纲Subversion简介Subversion安装Subversion配置Subversion操作常见问题Subversion操作Subversion简介秘密TSVN操作n工作副本的建立（检出）n修改n提交n回退修改n新增n删除n重命名n查看

5、文件状态n显示日志n文件差异比较n更新与同步n分支归并n冲突解决n导出特定版本进行构建秘密工作副本的建立-1：工作副本n工作副本：相当于CC中的一个静态视图，是私有工作区目录，可以用 Windows Explorer来查看n每个目录下都有一个 .svn 的隐藏目录，这个目录存放了 SVN的一些控制信息注意：不要手工修改或删除注意：不要手工修改或删除 .svn隐藏目录，否则会隐藏目录，否则会导致工作副本被破坏！导致工作副本被破坏！nSVN中的检出是指建立一个工作副本，不是CC中的checkout，且无需进行类似CC的checkout操作秘密工作副本的建立-2：浏览版本库n浏览版本库以确定访问路径

6、，桌面右键单击，如图：n在URL框中输入培训用版本库的地址：svn:/scm-bak/SCMTrain注意：SVN区分字母大小写！工作版本库地址为各项目配置人员提供秘密工作副本的建立-3：浏览版本库输入地址后远程服务器要求验证，输入有权限的用户名和密码l如果不想今后重复输入，可以选上 “保存认证”（Save authentication），那么今后本机访问这个版本库，除非是用户密码失效或更改，都不用再输入l为安全考虑，建议只在自己的常用机器上点选 “保存认证”秘密工作副本的建立-4：浏览版本库输入用户和密码后，看到整个项目版本库秘密工作副本的建立-5：检出在Windows资源管理器里选择一个事

7、先建好的存放工作副本的目录，右键单击，选择“SVN 检出”（“SVN Checkout”）：秘密工作副本的建立-6：检出可直接输入需检出文件夹的路径，也可以通过浏览按钮选择，如图：秘密工作副本的建立-7：检出输入地址后，远程服务器要求验证。验证成功后，项目文件从远程服务器下载到本地工作副本：秘密图标说明秘密修改n文件被检出到工作副本后，可以直接使用编辑工具进行修改，修改完成后请保存n完成“提交”（commit）操作后才真正将其放入版本库！秘密提交-1n当工作副本下文件内容被添加，删除，重命名，移动等操作后，工作副本的图标会变成带有“！”的标识 n选择“SVN提交”秘密提交-2n弹出文件提交对话

8、框，在“信息”中添加相关注释信息。要求填写本次提交的修改内容、原因及对应CQ的变更的变更idn多个文件提交时，应注意勾选变更列表中相关文件秘密回退修改n想要撤消一个文件自上次更新后的变更，相当于CC的undo checkout，右键单击，如图：n只有还没有“提交提交”的操作才可以回退！秘密新增-1n即在版本库中新增文件或目录，请谨慎！即在版本库中新增文件或目录，请谨慎！n将新增的内容拷贝到工作副本中正确位置，右键单击，选择TSVN 增加（Add）秘密新增-2n如果是添加目录的话，可以选择添加目录下的文件：n完成“提交”操作后才真正将其放入版本库！秘密删除n即删除版本库中文件或目录，请谨慎！即删

9、除版本库中文件或目录，请谨慎！n在工作副本目录中选择待删除的文件，右键单击，选择TSVN 删除（Delete）n不能直接使用Windows的delete命令！那样只是本地暂时删除，在更新工作副本后，删除的文件又会出现n完成“提交”操作后才真正生效！秘密重命名n在工作副本目录中选择要改名的文件，右键单击，选择TSVN 改名（Rename）n不能直接使用Windows的重命名命令！n完成“提交”操作后才真正生效！秘密检查更新-1如果要查看自上次提交以来有哪些文件有变化，在目录上右键单击， 选择TSVN 检查更新（Check for modifications）秘密检查更新-2弹出的对话框显示了工作

10、副本中做了修改的文件，也包括了当前存在的未受控的新文件秘密显示日志-1右击，选择TSVN 显示日志（Show log）： 秘密显示日志-2n选中某个版本会，会显示对应日志的具体内容n右键单击日志中某一版本可进行的一些操作：秘密文件差异比较-1：四种方式n本地更改和服务器比较n与其他分支/标签的比较n两个历史版本的比较n不同文件的比较 秘密文件差异比较-2：本地更改和服务器比较n用于在未提交时，查看工作副本中的某文件有哪些更改n对文件右键单击，TSVN 比较差异（Diff）：秘密文件差异比较-3：本地更改和服务器比较本地更改比较结果：秘密文件差异比较-4：与其他分支/标签的比较n用于比较同一文件

11、两分支/标签间的区别n在右键单击文件的同时按住Shift键，TSVN 以URL比较（Diff with URL） 选择比较对象(分支/标签)：秘密文件差异比较-5：两个历史版本的比较n用于查看任意已提交的两个历史版本之间的差异n在版本日志对话框中选择要比较的两个版本，然后在右键菜单中选“比较版本差异”：秘密文件差异比较-6：不同文件的比较 n用于查看两个不同文件之间的差异n在资源管理器中选择这两个文件，右键单击，TSVN 比较差异（Diff）：秘密更新与同步-1n定期从服务器上获取改动到本地工作副本n更新至最新版本：SVN更新（SVN Update）秘密更新与同步-2n查看以前的版本，可选择T

12、SVN 更新至版本（Update to revision）：秘密分支归并-1：两种方式n合并指定版本范围 这个方法是指在一个分支(或者最新版本)上做了一个或多个修改，想将部分(或全部) 修改应用到其他分支上n合并两个不同的目录树这个方法应用于例如新特性分支上的修改完成后，要将所有修改合并到主干最新版本，以保证主干最新版本和新特性分支同步秘密分支归并-2对接受归并的分支的工作副本的文件或目录，右键单击，选择TSVN 合并（Merge）秘密分支归并-3：合并指定版本范围 n起始框：输入源分支的文件路径和开始版本号（要合并的修改之前修改之前的版本号 ）n结束框：结束版本号（要合并的最后一个版本号，通

13、常是最新版本 ）此对话框的含义是，把起始框指定的51版本到结束框指定的53版本之间的差异（52、53）合并到工作副本秘密分支归并-4：选择版本范围n选择版本范围最简单的方法是：l点击显示日志，列出最近的修改和日志l如果要合并单个版本的修改，直接选取那个版本l如果要合并多个版本，就选择范围(Shift键)l点击确认后，会自动填写合并对话框的开始版本号和结束版本号。秘密分支归并-5：合并两个不同的目录树 n起始框：输入接受修改的分支的文件路径，开始版本号是最新版本n结束框：输入源分支的文件路径，结束版本号是最新版本在归并之前，最好先做预检和比较差异，以保证归并正确！秘密分支归并-6：预检 在合并操

14、作之前，预览（Dry run）工作副本的修改效果：秘密分支归并-7：比较差异 在合并操作之前，比较（Diff）待归并节点间的差异： 秘密冲突解决-1nSVN使用 拷贝拷贝-修改修改-合并合并 模型n有冲突的工作空间会在本地工作副本中存在这些文件，例如：readme.txt.mine：本地新修改的文件readme.txt.r23：在做修改之前所检出的文件readme.txt.r25：当前版本库中的最新版本秘密冲突解决-2n对冲突文件右键单击，TSVN 编辑-冲突 ，解决冲突部分：秘密冲突解决-3n解决了冲突后，消除文件冲突标记 TSVN 已解决n确定后，文件的图标显示改成提交图标：秘密导出特定版

15、本进行构建-1n导出的文件不带svn的图标标记，也没有.svn隐藏目录，为干净的目录树，便于版本构建n如果要导出当前工作副本中的文件，对要导出的文件，右键单击，选择TSVN 导出（Export）：秘密导出特定版本进行构建-2选择导出到指定路径：秘密导出特定版本进行构建-3如果要导出服务器上的某个目录的最新版本，任意右击，选择TSVN 导出（Export）：秘密导出特定版本进行构建-4导出到指定路径：秘密正式SVN库的目录结构n代码目录lMain ：主分支，修改分支lBranch：其他分支，修改分支lTag：标签，同CC中的按标签取版本，不能修改n文档目录秘密课程大纲课程大纲Subversion

16、安装Subversion配置Subversion操作Subversion简介常见问题秘密创建工作副本报错n创建工作副本报错：REPORT request failed on.Could not read chunk delimitern解决办法：更新工作副本秘密TSVN安装后资源管理器变慢-1n原因：TSVN安装后，“TSVNCache.exe”这个进程会扫描磁盘，简单来说工作副本中的文件有变化，绿色对勾图标变为红色感叹号，就是通过这个进程实现的。TSVN的扫描有时会和其他同样扫描磁盘的软件冲突，如ACDSEEn解决办法：1.由于SVN采用域的认证方式，所以首先要保持本机和域控之间的连通，配置

17、好网络连接秘密65TSVN安装后资源管理器变慢-2n解决办法：2.TSVN 设置，如图设置表示“TSVNCache.exe”进程仅在包含路径中指定的工作副本上进行扫描，显示图标“” 表示指定路径包含的所有文件和文件夹 排除所有驱动器排除所有驱动器 包含包含所有所有工作副本工作副本 秘密TSVN安装后资源管理器变慢-3n解决办法：3.如果1、2不能解决问题，可将“状态缓存”设置为“无”，但代价是TSVN不进行监控，工作副本没有图标提示，只能通过TSVN 检查更新，来检查工作副本和服务器版本库之间的变化秘密提交报错：423 locked-1n原因：该文件被锁秘密提交报错：423 locked-2n

18、解决办法：1.在版本浏览库上找到该文件,右键 破除锁定, 再做提交操作即可2.如果想检查目录下所有被锁文件，可以对目录右键，检查更新 检查版本库，会显示出锁定的文件信息，然后右键选择 破除锁定：秘密提交报错：MKACTIVITY,and 403 Forbiddenn原因：SVN 在 Check out 等操作时，是URL大小写不敏感的，可在 Commit、delete 时却是大小写敏感的，所以在设定SVN的服务器路径时，一定要注意大小写；也就是说检出时最好选择版本库目录，而不是手工敲，很容易产生大小写问题n解决办法：重新建工作副本，在Check out时，选用大小写正确的URL版本库目录秘密提

19、交报错：CHECKOUT,and 403 Forbiddenn原因：修改的所在分支没有修改权限n解决办法：请在创建工作副本时注意选择正确的分支秘密提交报错：file or directory out-of-daten原因：文件或目录过期，即本地工作副本自上次更新之后，版本服务器端已有其他更新，通常出现在多人修改同一文件的情况下n解决办法：更新工作副本！更新后，如果无冲突，SVN自动合并工作副本和服务器的更新；如有冲突则需手工解决冲突秘密如何修改svn文件/目录的大小写n使用版本库的浏览器重命名该文件的大写/小写为小写/大写，更改完成后更新工作副本n如果在工作副本中修改会报错秘密如何找回误操作的文件或目录-1n在工作副本上，找到误操作文件的所在目录上，TSVN 显示日志 ，找到误操作的那条日志 ，右键单击选择 “复原此版本中的变更” 或 “复原到此版本”，相关选择项的含义如下：l更新项目至版本：更新选中版本到工作副本，仅是更新到本地