源代码管理工具SVN使用手册大全客户端.docx

1、源代码管理工具SVN使用手册大全客户端目 录1. SVN客户端使用说明 11.1. 安装SVN客户端 11.2. 迁出配置库内容 11.3. 维护工作文件 31.3.1. 增加文件 31.3.2. 更新文件 71.3.3. 删除文件 81.3.4. 修改文件 81.3.5. 比较版本差异 91.3.6. 撤销更改 121.3.7. 锁定和解锁 121.3.8. 重命名文件 121.3.9. 获取历史文件 131.3.10. 检查冲突 131.3.11. 解决冲突 141.3.12. 忽略无需版本控制的文件 151.3.13. 去除SVN标志 151.3.14. 查看文件每行的修改信息 161.

2、3.15. 重置访问路径 171.3.16. 本地路径转换 171.4. 浏览版本库 171.5. 建立标签 171.6. 建立分支 171.7. 清除用户名等信息 181.8. 统计信息 191.9. SVN数据同步 222. Visual Studio集成SVN 222.1. 安装VisualSVN 221. SVN客户端使用说明1.1. 安装SVN客户端安装SVN客户端（TortoiseSVN-1.8.7.25475-x64-svn-1.8.9.msi）：双击安装包Next选中“I accept the terms in the license Agreement”NextInstall

3、选中“Show Changelog”Finish点击“Yes”按钮重新启动电脑。SVN客户端的存放位置为：注意：安装SVN客户端后需重启电脑，否则SVN客户端无法正常使用。可以下载TortoiseSVN的中文语言包，根据向导运行语言包安装程序，重新启动程序后，即可看到中文菜单。所有的TortoiseSVN命令都是通过windows资源管理器的右键菜单执行。1.2. 迁出配置库内容1、在本地硬盘上建立一个文件夹“SVN”，并在文件夹“SVN”中建立一个子文件夹（子文件夹为空文件夹），子文件夹的名称可以根据本公司配置库路径下的对应文件夹名称进行定义。例如在SVN中建立一个test子文件夹。2、鼠标

4、选中文件夹“test”右键选择“SVN Checkout.”，如下图所示：4、在弹出的窗口中URL of repository栏中输入您要访问的配置库路径，如http:/test（此路径为实验路径，输入时依具体配置库路径而定，可以为根目录的路径也可以为子目录的路径，目录选择要适当），如下图所示：点击“OK”按钮。备注：在Revision栏中选择“HEAD revision”项只能获得所输入路径下的最新版本文件。选择“Revision”项可以输入或选择此路径下的任意历史版本文件。如果点击“Showlog”按钮会弹出如下信息框：此信息框为版本日志对话框，在此信息框中可以选择某一历史版本。5、在弹出

5、的窗口Authentication中的Username栏输入用户名，在Password栏输入用户密码，如下图所示：可选择Save authentication复选框保存用户名和密码。点击“OK”按钮下载配置库中test路径的文件到本地硬盘上的test文件中。下载完毕后本地文件夹显示为如下图标：1.3. 维护工作文件1.3.1. 增加文件将需要增加的新文件放入到本地迁出的文件夹test目录的相应位置中，鼠标选中新文件右键选择“TortoiseSVN”的“Add”项，如下图所示：备注：此步骤也可通过右键选择“TortoiseSVN”的“Import.”项实现。在你的硬盘上创建一个空的文件夹，在此文

6、件夹下只放入你要提交到配置库中的文件（所提交文件的目录结构已在本地设置完成，且不要放入非提交到配置库的文件），后在此文件夹的空白处右键选择“TortoiseSVN”的“Import.”项输入你要上传的路径和相关信息，点击“OK”按钮实现上传。如下图所示：系统弹出信息框如下图所示：点击“OK”按钮，系统弹出信息框如下图所示：点击“OK”按钮。此时新文件图标显示如下图：这时本地硬盘test文件夹图标显示如下图：鼠标选中本地硬盘test文件夹右键选择“SVN Commit”项，将新文件上传配置库对应文件夹中（此时将本地硬盘test文件下修改的内容都上传到配置库中，若只上传单个文件，只需点中单个文件上

7、传即可），如下图所示： 在系统弹出的信息框Enter Log Message的Message栏中填写本次操作的注释，如下图所示：其中，选中Show unversioned files复选框则显示不处于版本控制下的文件；选中Select/deselect all复选框表示全部选择/全部不选择。点击“OK”按钮，系统弹出信息框Authentication，如下图所示：在Username栏中输入用户名，在Password栏中输入用户密码，点击“OK”按钮，系统弹出如下信息框：点击“OK”按钮，结束本次操作。备注：可在IE地址栏中输入http:/test验证“新文件”是否已经增加。1.3.2. 更新文

8、件当你从配置库中迁出相应目录后，他人对服务器上此目录内容进行了修改，你需要再次获取改动内容到你本地硬盘空间目录（即先前已迁出的目录）的过程称为更新。更新可以针对一个文件、几个选中的文件或者整个文件目录。选中要被更新的文件，右键选择“SVN Update”项，如下图所示：点击“SVN Update”后会弹出窗口显示更新的进度，如下图所示：若上述框中的有文件出现亮红，说明来自配置库的内容与你本地修改内容合并时出现了冲突，解决方法详见本文档1.3.11解决冲突。1.3.3. 删除文件选中要被删除的文件，右键选择“TortoiseSVN”的“Delete”项，如下图所示：删除文件后，鼠标选中test文

9、件夹右键选择“SVN Commit”项进行提交，提交方式同增加文件的提交方式，提交后则将新文件从配置库中删除。最后在IE地址栏中输入http:/test验证“新文件”是否已经删除。1.3.4. 修改文件选中本地硬盘test文件夹，右键选择“TortoiseSVN”的“SVN Update”项更新本地文件，里面的文件都有特殊标识，如“江西空中充值项目”的标识显示为：打开“江西空中充值项目”修改部分内容，保存后退出。“江西空中充值项目”图标显示为：鼠标选中“江西空中充值项目”右键选择“SVN Commit”项提交，系统弹出如下信息框：在Message栏中填写修改文件的注释（这时可以点击“Recen

10、t messages”按钮查看本文档以前版本的注释信息），点击“OK”按钮进行提交，提交方式同增加文件的提交方式。在提交前可以在上图中双击“江西空中充值项目”文本文件查看既要提交的修改内容（比较上一版本所修改的内容，此步骤可直接在本地磁盘中通过右键选择“TortoiseSVN”的“Check for modifications”或“Diff”项实现）。提交文件前，也可通过选中“江西空中充值项目”右键进行相关操作，如下图所示：1.3.5. 比较版本差异 本地更改内容与更改前内容比较如果你想看到你本地的“江西空中充值项目”文本内容有哪些更改，鼠标选中“江西空中充值项目” 文本右键选择“Tortoi

11、seSVN”的“Diff”项，系统弹出差异内容。 本地更改内容与历史版本的比较如果你想查看你本地的“江西空中充值项目”文本内容与其历史版本之间的差异，鼠标选中“江西空中充值项目” 文本右键选择“TortoiseSVN”的“Show log”项显示日志对话框，在日志对话框选择要比较的历史版本，后右键选择“Compare with working copy”项，如下图所示：点击后，系统弹出差异内容，如下图所示： 两个历史版本的比较如果你要查看“江西空中充值项目”文本任意已提交的两个历史版本之间的差异，在上述日志对话框中选择你要比较的两个版本，右键选择“Compare revisions”项，系统弹

12、出差异内容。 与另外一个分支/标签之间的比较如果你想查看“江西空中充值项目”文本的某一分支(假如你在主线上开发)有哪些修改，选“江西空中充值项目”文本文件的同时按住Shift键，后右键选择“TortoiseSVN”的“Diff with URL”。如下图所示：在弹出的对话框中输入要比较的URL地址。如下图所示：点击“OK”按钮后，系统弹出差异内容。 比较两个文件差异如果你想查看同一目录下两个没有关系的文件差异，选中这两个文件，右键选择“TortoiseSVN”的“Diff”项，系统弹出这两个文件的差异内容。 比较两个文件夹差异如果你想查看两个不同的文件夹之间的差异，需使用版本库浏览器打开此目录

13、，选中要比较的两个文件夹，右键选择“Compare revisions”项，如下图所示：单击后系统弹出这两个文件夹的修改列表，如下图所示：可以选择上图中单个文件右键进行相关操作。 比较两个图像差异如果你想查看两个不同的图像之间的差异，选中要比较的两个图像或者选中被修改的图像，右键选择“TortoiseSVN”的“Diff”项，系统弹出这两个图像的差异内容。如下图所示：1.3.6. 撤销更改在修改了某些文件后（文件未上传到配置库），需要返回到修改前的状态，则选中文件夹test右键选择“TortoiseSVN”的“Revert.”项进行撤销，本地硬盘上的文件将恢复到修改前的内容，修改的内容将被删除

14、。1.3.7. 锁定和解锁当项目需要时可以在你本地硬盘中将你迁出的内容进行锁定，选中要被锁定的文件右键选择“TortoiseSVN”的“Get lock.”项进行锁定（锁定后他人将无法修改此文件），系统弹出锁定信息框，如下图所示：点击“OK”按钮即可将“江西空中充值项目”文本文件锁定，锁定后显示如下：解锁时选中被锁定的文件右键选择“TortoiseSVN”的“Release lock”项进行解锁。1.3.8. 重命名文件鼠标选中“江西空中充值项目”文本文件右键选择“TortoiseSVN”的“rename.”项，系统弹出如下信息框：在New name框中输入新文件名后点击“OK”按钮，将出现重

15、命名后的文件，原文件被删除，将它们提交后重命名生效。1.3.9. 获取历史文件 查看历史文件鼠标选中文件夹test右键选择“TortoiseSVN”的“Show log”项，系统弹出此路径下的所有文件版本信息，如下图所示：此时也可双击“江西空中充值项目”文本文件查看修改的内容（比较上一版本所修改的内容）。 获取历史文件鼠标选中文件夹test右键选择“TortoiseSVN”的“Update to revision”项，后系统提示需要选择下载的版本，如下图所示： “Revision”栏中“HEAD revision”为最新版本，“Revision”手工输入版本号，也可点击“Show log”按钮

16、选择需要的版本内容，选择版本19后，点击“OK”按钮，系统弹出如上信息框：点击“OK”按钮，系统开始下载文件，下载完毕后提示框如下：点击“OK”按钮，结束本次操作。1.3.10. 检查冲突在提交你修改的文件到配置库前，可先检查本地修改的内容是否与配置库中的内容冲突。选中修改的文件或文件夹，右键选择“TortoiseSVN”的“Check for modifications”项，将显示所有被修改的内容，检查“江西空中充值项目”文本如下图所示：点击上图中“Check repository”按钮，后双击“江西空中充值项目”文本或右键处理，则显示出此文件在配置库中的改动内容和你本地的改动内容，判断是否

17、存在冲突，如下图所示：上图表明存在冲突，可以直接右键在上图中进行修改解决冲突（如上图灰色所示），或者将发生冲突的文件拖到文本编辑器或者其它应用程序中进行修改，也可选中发生冲突的文件右键选择“Open”或“Open with”打开文件进行修改解决冲突。1.3.11. 解决冲突当你Update“江西空中充值项目”文本文件出现冲突时，Subversion会产生三个文件：“江西空中充值项目.txt.mine”；“江西空中充值项目.txt.r19” ；“江西空中充值项目.txt.r20”，如下图所示：在“江西空中充值项目”文本文件冲突的内容中，冲突的地方将使用“”标示出来，查找以字符串Propertie

18、s2. 在Properties对话框里点Add3. 在Add properties界面属性下拉框选svn:externals，输入属性值。在Property value中添加external对象“工程文档”和被同步的路径，如图：注意：复选框Apply property recursively是“是否要在抚州水力的每个子目录下面都共享添加http:/seaway/快易营业点平台/工程文档”的内容。如果选中，抚州水力的每个子目录下都会自动增加工程文档目录。增加该属性后，你本地文件为已修改状态，先Update更新配置库中的最新内容，后提交修改到配置库中，在配置库生效。加该属性后，再更新抚州水力目录的

19、时候，自动在抚州水力目录下建工程文档目录，并把“http:/seaway/快易营业点平台/工程文档”里面的内容保存到“http:/localhost:2003/seaway/抚州水力/工程文档”里。如果更新“http:/localhost:2003/seaway/抚州水力/工程文档”目录里文件的内容，做commit，对该文件的修改也会保存到“http:/seaway/快易营业点平台/工程文档”里面。2. Visual Studio集成SVN2.1. 安装VisualSVN本文以VisualSVN-4.0.8.msi为例。安装Visual Studio 2013. 菜单集成： 右键菜单集成：Pending Changes面板