1、SVN使用指南使用指南Windows环境版环境版1谢谢观赏2019-5-22内内 容容 概概 要要 问题与案例 SVN简介 应用环境 客户端安装 简单应用 复杂应用2谢谢观赏2019-5-22问题与案例（一）问题与案例（一） 电脑发生故障，文件没有备份而丢失了 由于人员离职，导致某些资料丢失了 我怎么知道手头的公共资料是不是最新版呢？ 想要追溯几个月前的某个状态，却发现那个版本的文件已经被当作垃圾删除了 每天要花费很多时间来向别人提供需要共享的资料Back3谢谢观赏2019-5-22问题与案例（二）问题与案例（二） 相似的应用系统，每次都重复开发，难以复用 一个软件被用于多个项目，发现其中存在
2、一个BUG，所有这些项目都要进行修复 人员分布在两地开发，版本如何同步 甲乙两人为不同目的修改了同一份文件，乙的提交在甲提交之后，导致甲修改的内容丢失了 客户测试发现了BUG，开发人员却无法重现出来Back4谢谢观赏2019-5-22SVN简介（一）简介（一）BackSVN5谢谢观赏2019-5-22SVN简介（二）简介（二） 一个开源的版本管理软件 可架设在Apache上，使用http或https协议访问；也可使用内置的svn协议访问 在Windows环境下，最常用的客户端为TortoiseSVN（简称TSVN） 在Linux/Unix环境下，用命令行方式操作 SVN的版本号指的不是某个文件
3、的状态，而是整个库的状态Back6谢谢观赏2019-5-22应用环境应用环境 服务器端：CollabNet的SVN服务器端安装包（内含Apache2.2） Windows客户端：推荐使用TortoiseSVN（以下简称TSVN） 可通过TSVN进行读、写操作 可通过IE浏览器进行读操作 可通过各种插件与开发工具集成Back7谢谢观赏2019-5-22客户端安装（一）客户端安装（一） 安装文件： TSVN客户端： TortoiseSVN-1.6.8.19260-win32-svn-1.6.11.msi TSVN中文语言包： LanguagePack_1.6.8.19260-win32-zh_CN
4、.msi 全部选择默认安装，安装完成后重启电脑 TSVN通过右键菜单与Windows资源管理器集成，没有自己的窗口界面Back8谢谢观赏2019-5-22客户端安装（二）客户端安装（二） TSVN通过右键菜单与Windows资源管理器集成，没有自己的窗口界面Back9谢谢观赏2019-5-22简单应用简单应用 TSVN右键菜单与图标 创建版本库 检出 更新 提交 增加 删除 改名 移动Back10谢谢观赏2019-5-22TSVN右键菜单（一）右键菜单（一）Back第一次从服务器下载数据（含历史信息）查看服务器上版本库内容从服务器下载数据（不含历史信息）在服务器上创建新的版本库（限服务器上操作
5、）导入新版本库的目录结构（不推荐使用）11谢谢观赏2019-5-22TSVN右键菜单（二）右键菜单（二）Back从服务器上下载最新版本将本地的修改上传到服务器查看修订历史信息标记冲突已经被解决取回之前的某个版本放弃本次进行的修改SVN控制下的改名和删除将新文件纳入SVN的控制创建分支或标记合并分支12谢谢观赏2019-5-22TSVN图标图标Back13谢谢观赏2019-5-22创建版本库创建版本库 在SVN服务器端操作 在相应文件夹内新建一个文件夹，用于存储数据 在新建文件夹上点右键，选择“TortoiseSVN在此创建版本库”，TSVN会在此文件夹内建立若干控制文件Back14谢谢观赏20
6、19-5-22检出（一）检出（一） “检出”用于客户端第一次从SVN服务器上下载版本库数据 在客户端新建一个文件夹用于存放下载的数据 在新建文件夹上点右键，选择“SVN检出”Back15谢谢观赏2019-5-22检出（二）检出（二） 在弹出窗口的“版本库URL”处填入版本库的访问地址，如：http:/10.50.22.35:8080/svn/XXX部门/XXXX项目/ 点“确定”开始从SVN服务器下载数据Back16谢谢观赏2019-5-22更新更新 “更新”用于客户端从SVN服务器下载最新版本 在受SVN控制的某层文件夹上（或文件夹内空白处）点右键，选择“SVN更新”，TSVN自动比较该文件
7、夹客户端与服务器的版本差异，并下载最新版本到客户端Back17谢谢观赏2019-5-22提交（一）提交（一） “提交”用于将客户端的改动上传到SVN服务器 在受SVN控制的某层文件夹上（或文件夹内空白处，或某文件上）点右键，选择“SVN提交”Back18谢谢观赏2019-5-22提交（二）提交（二） TSVN自动检查该文件夹客户端的改动，并将其列在弹出窗口的“变更列表”栏 在弹出窗口的“信息”栏写上对此次提交的注释，以便将来追溯 点击“确定”将客户端的改动上传到服务器Back19谢谢观赏2019-5-22增加（一）增加（一） “增加”用于将新文件或文件夹纳入SVN的控制之下 在受SVN控制的某
8、层文件夹上（或文件夹内空白处，或新增的某文件上）点右键，选择“TortoiseSVN增加”Back20谢谢观赏2019-5-22增加（二）增加（二） 如果“增加”是对文件夹进行操作，则会弹出窗口列出该文件夹下未受控的文件，点击“确定”将其纳入SVN控制 “增加”后文件图标从 变成 “增加增加”仅是对客户端的文件进行标注，仅是对客户端的文件进行标注，并不上传到服务器，需要执行并不上传到服务器，需要执行“提交提交”操操作才会上传作才会上传Back21谢谢观赏2019-5-22删除（一）删除（一） “删除”用于从当前版本中删除文件或文件夹 在受SVN控制的文件夹中，通过Windows直接删除子文件夹
9、或文件 或：在受SVN控制的某层文件夹或文件上点右键，选择“TortoiseSVN删除”Back22谢谢观赏2019-5-22删除（二）删除（二） “删除删除”仅是对客户端的文件进行操作，并仅是对客户端的文件进行操作，并不改变服务器上的内容，需要执行不改变服务器上的内容，需要执行“提交提交”操作才会将删除操作上传到服务器操作才会将删除操作上传到服务器 将将“删除删除”操作操作“提交提交”到服务器后，仅到服务器后，仅是从服务器的最新版本中删除了此文件或是从服务器的最新版本中删除了此文件或文件夹，在历史版本中仍可找回此文件或文件夹，在历史版本中仍可找回此文件或文件夹文件夹Back23谢谢观赏201
10、9-5-22改名（一）改名（一） “改名”用于在受SVN控制的状态下，对文件或文件夹改名 在受SVN控制的某层文件夹或文件上点右键，选择“TortoiseSVN改名”Back24谢谢观赏2019-5-22改名（二）改名（二） “改名改名”仅是对客户端的文件进行操作，并仅是对客户端的文件进行操作，并不改变服务器上的内容，需要执行不改变服务器上的内容，需要执行“提交提交”操作才会将改名操作上传到服务器操作才会将改名操作上传到服务器 不要用不要用Windows“重命名重命名”来实现改名，因来实现改名，因为这个操作不受为这个操作不受SVN控制，控制，SVN会将其理会将其理解为删除原文件、增加一个新文件
11、，从而解为删除原文件、增加一个新文件，从而导致文件改名后不能跟踪到改名前的状态导致文件改名后不能跟踪到改名前的状态Back25谢谢观赏2019-5-22改名（三）改名（三） 改名的另一种方法： 在受SVN控制的某层文件夹或文件上点右键，选择“TortoiseSVN版本库浏览器” 在弹出窗口右键点击要改名的文件夹或文件，选择“改名” 由于是对服务器版本库直接操作，改名后将自动执行一次“提交”操作 改名完成后需要在客户端执行一次“更新”，以下载最新状态Back26谢谢观赏2019-5-22移动（一）移动（一） “移动”用于在受SVN控制的状态下，移动文件或文件夹的位置 在受SVN控制的某层文件夹或
12、文件上点右键，选择“TortoiseSVN版本库浏览器” 在弹出窗口拖动文件夹或文件到需要的位置 由于是对服务器版本库直接操作，移动后将自动执行一次“提交”操作 移动完成后需要在客户端执行一次“更新”，以下载最新状态Back27谢谢观赏2019-5-22移动（二）移动（二） 不要用不要用Windows的拖动操作或的拖动操作或“剪切剪切”、“粘贴粘贴”来实现移动，因为这些操作不受来实现移动，因为这些操作不受SVN控制，控制，SVN会将其理解为在原位置删会将其理解为在原位置删除文件、在新位置增加文件，从而导致文除文件、在新位置增加文件，从而导致文件移动后不能跟踪到移动前的状态件移动后不能跟踪到移动
13、前的状态Back28谢谢观赏2019-5-22复杂应用复杂应用 更新至版本 还原 复原（回滚） 冲突及解决 分支/标记 合并 锁定/解锁 权限管理Back29谢谢观赏2019-5-22更新至版本更新至版本 “更新至版本”用于取出文件的某历史版本 在受SVN控制的某层文件夹或文件上点右键，选择“TortoiseSVN更新至版本” 在弹出窗口中填写要取的版本号，点“确定”取回该版本Back30谢谢观赏2019-5-22还原（一）还原（一） “还原”用于放弃“增加”、“删除”、“改名”以及修改文件内容等客户端的本地操作，将客户端的数据恢复到改动前的版本状态 在受SVN控制的某层文件夹或文件上点右键，
14、选择“TortoiseSVNSVN还原”Back31谢谢观赏2019-5-22还原（二）还原（二） 在弹出窗口中查看要还原的内容，点击“确定”还原客户端数据 “还原”只能用于执行“提交”操作之前，即未将客户端的改变上传到服务器之前Back32谢谢观赏2019-5-22复原（回滚）（一）复原（回滚）（一） 复原（回滚）用于将项目恢复到之前的某个版本状态，并在此版本基础上继续后面的工作 在受SVN控制的某层文件夹或文件上点右键，选择“TortoiseSVN显示日志”Back33谢谢观赏2019-5-22复原（回滚）（二）复原（回滚）（二） 在弹出的日志窗口中，右键点击要复原的版本，选择“复原到此版
15、本” 复原结束后，执行“提交”操作，将此版本作为版本库的最新版本Back34谢谢观赏2019-5-22冲突及解决（一）冲突及解决（一） 冲突的产生： 当两人从同一个版本出发，修改同一份文件并提交时，这两个修改版本就会发生冲突，后提交的人会收到发生冲突的提醒，且提交失败，要求先进行更新操作Back35谢谢观赏2019-5-22冲突及解决（一）冲突及解决（一）113114115113114115Back不会导致冲突不会导致冲突可能导致冲突可能导致冲突36谢谢观赏2019-5-22冲突及解决（三）冲突及解决（三） 发生冲突后，执行“更新”操作后： 对于发生冲突的文件，TSVN会加上冲突标记 如果发生
16、冲突的文件是二进制文件（如doc文件、jpg文件），TSVN会增加2个文件，分别是起始版本和发生冲突的版本 如果发生冲突的文件是文本文件（如c文件、txt文件），TSVN会将工作副本中的原文件改名增加“.mine”后缀，将两个版本的冲突写入原名文件（文件中用加以标识），并另外增加2个文件，分别是起始版本和发生冲突的版本Back37谢谢观赏2019-5-22冲突及解决（四）冲突及解决（四） 例如：两人从第213版开始对start.c和SRS.doc进行修改，甲先修改完成并提交形成217版，乙随后提交时发生冲突，则在乙的该文件夹下将会存在七个文件： start.c：自动合并了甲和乙的修改内容的st
17、art.c start.c.r213：甲乙修改前的start.c start.c.r217：甲修改后的strat.c start.c.mine：乙修改后的start.c SRS.doc：乙修改后的SRS.doc SRS.doc.r213 ：甲乙修改前的SRS.doc SRS.doc.r217：甲修改后的SRS.docBack38谢谢观赏2019-5-22冲突及解决（五）冲突及解决（五） 解决冲突： 手工将前一版本中的修改整合到自己的文件中 在冲突的文件或文件夹上点右键，选择 “Tortoise已解决的”，标记为冲突已解决（此时会自动删除多余的文件），然后再次“提交”Back39谢谢观赏2019
18、-5-22分支分支/标记（一）标记（一） 分支： “分支”通常用于在不同的线上同时工作的情况 “分支”通常设置为分支的所有者拥有读写权限，其他人员仅有读取权限 标记 “标记”通常用于版本发布、标识基线状态等情况 “标记”通常设置为配置管理员拥有读写缺陷，其他人员只有读取权限 SVN使用同样的操作进行“分支”和“标记”Back40谢谢观赏2019-5-22分支分支/标记（二）推荐的目录结构标记（二）推荐的目录结构Backprojecttrunkbranchestags代码文档41谢谢观赏2019-5-22分支分支/标记（三）案例一标记（三）案例一709XXX软件软件711工行版工行版712建行版
19、建行版713农行版农行版714718720726717719722727716721728715723724730710Release_V1_0725Release_V1_1tags标记标记trunk主干主干branches分支分支729Back42谢谢观赏2019-5-22分支分支/标记（四）案例二标记（四）案例二711XXX软件软件713V1_0维护维护715717719714716718720712Release_V1_01012Release_V2_0tags标记标记trunk主干主干branches分支分支10111013V2_0维护维护Back43谢谢观赏2019-5-22分支分支
20、/标记（五）案例三标记（五）案例三Back712XXX软件软件713BUG037717718720721714715716719trunk主干主干branches分支分支722发现BUG，编号03744谢谢观赏2019-5-22分支分支/标记（六）创建分支标记（六）创建分支 在受SVN控制的某层文件夹上点右键，选择“TortoiseSVN分支/标记” 在弹出窗口的“至URL”栏，填写分支的存放地址，通常将其存放到branches目录下，并加上分支的名称，如：http:/10.50.22.35:8080/svn/软件中心/project/branches/工行版Back45谢谢观赏2019-5-
21、22分支分支/标记（七）创建分支标记（七）创建分支 在弹出窗口的“从此复制到版本库”处选择从“最新版本”或 “指定版本”或“工作副本”（工作副本可能是个混合版本）复制 在弹出窗口的“日志信息”栏填写注释信息，然后点击“确定” 在对应的文件夹执行“更新”操作，下载分支到客户端，之后对分支的操作均在此文件夹进行Back46谢谢观赏2019-5-22分支分支/标记（八）创建标记标记（八）创建标记 创建标记与创建分支类似，只是通常将其存放到tags目录下，如：http:/10.50.22.35:8080/svn/软件中心/project/tags/Release_V1_0 标记实际是为某个版本做了个标
22、签，不会为另存一份而消耗服务器的存储空间Back47谢谢观赏2019-5-22合并（一）合并（一） 合并：对两个版本树进行比较，然后将区别应用到本地副本（合并后需进行“提交”操作） 例如：在分支A上进行了一系列修改，现在要将这些修改合并到主干上，则可比较建立A分支的版本与A分支最终版本之间的差异，并将差异应用到主干上 可从分支合并到主干，也可从主干合并到分支，也可从分支A合并到分支B 可选择合并创建分支以来的所有改变，也可选择合并创建分支以来的某几个版本的改变Back48谢谢观赏2019-5-22合并（二）合并（二） 在目标文件夹上点右键，如要将“branches/工行版”分支的内容合并到主干
23、上，则在“trunk”文件夹上点右键，选择“Tortoise合并” 在弹出窗口选择“合并一个版本范围”（常用选择） 点击“下一条”Back49谢谢观赏2019-5-22合并（三）合并（三） 在“合并的源URL”处选择要合并进来的分支地址，如：http:/10.50.22.35:8080/svn/软件中心/project/branches/工行版 在“待合并的版本范围”处填入合并的版本范围，可点击边上的“显示日志”选择版本 点击“下一条”Back50谢谢观赏2019-5-22合并（四）合并（四） 合并深度选择默认的“工作副本” “比较空白字符”、“忽略空白字符的变化”等选择用于对文本文件的比较
24、“测试合并”可在正式合并之前测试合并结果，比如是否存在冲突等 点击“合并” 若未发生冲突，可在合并后执行“提交”操作Back51谢谢观赏2019-5-22合并（五）合并（五） 若合并时发生冲突，通常可在弹出窗口选择“以后解决”，在本地副本中冲突的文件处将增加2个文件（对二进制文件）或3个文件（对文本文件） 手动解决冲突后，使用“Tortoise已解决的”标记冲突已解决，然后执行“提交”操作Back52谢谢观赏2019-5-22锁定锁定/解锁（一）解锁（一） 为了便于多人协作，SVN不提倡“锁定修改解锁”的方式 由于存在冲突解决的机制，通常多人可对同一份文件进行修改，而不会导致严重问题 但在某些
25、情况下，比如对一张图片进行修改时，两份冲突的图片文件将很难被整合到一起，这时建议用锁定/解锁的方式Back53谢谢观赏2019-5-22锁定锁定/解锁（二）解锁（二） 锁定方法一 在需要锁定的文件夹或文件上点右键，选择“Tortoise属性” 在弹出的“属性”窗口选择“新建”，在弹出的“增加属性”窗口，选择“svn:needs-lock”属性，并点“确定”增加属性 执行“提交”操作，将属性的改变上传到服务器，若他人执行更新操作，将看到文件被设置为只读Back54谢谢观赏2019-5-22锁定锁定/解锁（三）解锁（三） 在设置了needs-lock属性的文件或文件夹上点右键，选择“SVN获取锁定
26、”，以获取锁的拥有权 在弹出窗口输入锁定的原因等注释信息，然后点击“确定”获取锁定 获取锁的拥有权后，文件将被标识为Back55谢谢观赏2019-5-22锁定锁定/解锁（三）解锁（三） 锁定方法二 在要锁定的文件或文件夹上点右键，选择“Tortoise 获取锁定”，即可锁定并拥有其所有权，文件将被标识为 采用此锁定方法时，并不会自动设定svn:needs-lock属性，别人更新后也看不到此标记 ，但可阻止别人的提交Back56谢谢观赏2019-5-22锁定锁定/解锁（四）解锁（四） 锁定后，他人提交时将被报告文件已被锁，并提交失败 解锁： 对应锁定方法一：在锁定的文件夹或文件上点右键，选择“T
27、ortoise属性”，删除svn:needs-lock属性，然后提交 对应锁定方法二：当拥有锁的人提交被锁定文件时，锁将被自动取消（而且当前拥有的所有锁都将被解除）；也可通过“解除锁定”来解锁 窃取锁：他人可通过“获取锁定” （勾选“偷取此锁定”）来窃取锁的拥有权 强制解锁：当拥有锁的人忘记解锁时，他人可通过SVN命令行强制解锁（TSVN目前不提供该功能，可通过窃取锁解锁实现）Back57谢谢观赏2019-5-22权限管理权限管理 管理员可通过修改服务器上的权限文件，实现对权限的控制 权限分为三种：无权限、只读权限和读写权限 权限的控制以文件夹为最小单位 可对单个用户的权限进行控制，也可以对用户组的权限进行控制Back58谢谢观赏2019-5-2259谢谢观赏2019-5-2260谢谢观赏2019-5-22
