源代码管理工具-SVN使用手册大全(客户端)

Muchinfo SVN使用手册V1.0.0.1

目 录

1.

SVN客户端使用说明 ........................................................................................ 1

1.1.

1.2.

1.3.

安装SVN客户端 ......................................................................................................... 1

迁出配置库内容 ........................................................................................................... 1

维护工作文件 ............................................................................................................... 3

1.3.1. 增加文件 ........................................................................................................... 3

1.3.2. 更新文件 ........................................................................................................... 7

1.3.3. 删除文件 ........................................................................................................... 8

1.3.4. 修改文件 ........................................................................................................... 8

1.3.5. 比较版本差异 ................................................................................................... 9

1.3.6. 撤销更改 ......................................................................................................... 12

1.3.7. 锁定和解锁 ..................................................................................................... 12

1.3.8. 重命名文件 ..................................................................................................... 12

1.3.9. 获取历史文件 ................................................................................................. 13

1.3.10. 检查冲突......................................................................................................... 13

1.3.11. 解决冲突 ......................................................................................................... 14

1.3.12. 忽略无需版本控制的文件 ............................................................................. 15

1.3.13. 去除SVN标志 ............................................................................................... 15

1.3.14. 查看文件每行的修改信息 ............................................................................. 16

1.3.15. 重置访问路径 ................................................................................................. 17

1.3.16. 本地路径转换 ................................................................................................. 17

1.4. 浏览版本库 ................................................................................................................. 17

1.5. 建立标签 ..................................................................................................................... 17

1.6. 建立分支 ..................................................................................................................... 17

1.7. 清除用户名等信息 ..................................................................................................... 18

1.8. 统计信息 ..................................................................................................................... 19

1.9. SVN数据同步 ............................................................................................................ 22

2.

VISUAL STUDIO集成SVN ........................................................................... 23

2.1. 安装VISUALSVN ....................................................................................................... 23

Muchinfo SVN使用手册V1.0.0.1

1. SVN客户端使用说明

1.1. 安装SVN客户端

安装SVN客户端（）：双击安装包→Next→选中“I accept the terms in the license Agreement”→Next→Install→选中“Show Changelog”→Finish→点击“Yes”按钮重新启动电脑。

SVN客户端的存放位置为：

注意：安装SVN客户端后需重启电脑，否则SVN客户端无法正常使用。

可以下载TortoiseSVN的中文语言包，根据向导运行语言包安装程序，重新启动程序后，即可看到中文菜单。

所有的TortoiseSVN命令都是通过windows资源管理器的右键菜单执行。

1.2. 迁出配置库内容

1、在本地硬盘上建立一个文件夹“SVN”，并在文件夹“SVN”中建立一个子文件夹（子文件夹为空文件夹），子文件夹的名称可以根据本公司配置库路径下的对应文件夹名称进行定义。例如在SVN中建立一个test子文件夹。

2、鼠标选中文件夹“test”右键选择“”，如下图所示：

4、在弹出的窗口中URL of repository栏中输入您要访问的配置库路径，如/test（此路径为实验路径，输入时依具体配置库路径而定，可以为根目录的路径也可以为子目录的路径，目录选择要适当），如下图所示：

点击“OK”按钮。

备注：在Revision栏中选择“HEAD revision”项只能获得所输入路径下的最新版本文件。选择“Revision”项可以输入或选择此路径下的任意历史版本文件。如果点击“Showlog”按钮会弹出如下信息框：

Muchinfo SVN使用手册V1.0.0.1

此信息框为版本日志对话框，在此信息框中可以选择某一历史版本。

5、在弹出的窗口Authentication中的Username栏输入用户名，在Password栏输入用户密码，如下图所示：

可选择Save authentication复选框保存用户名和密码。

点击“OK”按钮下载配置库中test路径的文件到本地硬盘上的test文件中。下载完毕后本地文件夹显示为如下图标：

Muchinfo SVN使用手册V1.0.0.1

1.3. 维护工作文件

1.3.1. 增加文件

将需要增加的新文件放入到本地迁出的文件夹test目录的相应位置中，鼠标选中新文件右键选择“TortoiseSVN”的“Add”项，如下图所示：

备注：此步骤也可通过右键选择“TortoiseSVN”的“”项实现。在你的硬盘上创建

Muchinfo SVN使用手册V1.0.0.1

一个空的文件夹，在此文件夹下只放入你要提交到配置库中的文件（所提交文件的目录结构已在本地设置完成，且不要放入非提交到配置库的文件），后在此文件夹的空白处右键选择“TortoiseSVN”的“”项输入你要上传的路径和相关信息，点击“OK”按钮实现上传。如下图所示：

系统弹出信息框如下图所示：

点击“OK”按钮，系统弹出信息框如下图所示：

Muchinfo SVN使用手册V1.0.0.1

点击“OK”按钮。此时新文件图标显示如下图：

这时本地硬盘test文件夹图标显示如下图：

鼠标选中本地硬盘test文件夹右键选择“SVN Commit…”项，将新文件上传配置库对应文件夹中（此时将本地硬盘test文件下修改的内容都上传到配置库中，若只上传单个文件，只需点中单个文件上传即可），如下图所示：

在系统弹出的信息框Enter Log Message的Message栏中填写本次操作的注释，如下图所示：

Muchinfo SVN使用手册V1.0.0.1

其中，选中Show unversioned files复选框则显示不处于版本控制下的文件；选中Select/deselect all复选框表示全部选择/全部不选择。

点击“OK”按钮，系统弹出信息框Authentication，如下图所示：

在Username栏中输入用户名，在Password栏中输入用户密码，点击“OK”按钮，系统弹出如下信息框：

Muchinfo SVN使用手册V1.0.0.1

点击“OK”按钮，结束本次操作。

备注：可在IE地址栏中输入/test验证“新文件”是否已经增加。

1.3.2. 更新文件

当你从配置库中迁出相应目录后，他人对服务器上此目录内容进行了修改，你需要再次获取改动内容到你本地硬盘空间目录（即先前已迁出的目录）的过程称为更新。更新可以针对一个文件、几个选中的文件或者整个文件目录。

选中要被更新的文件，右键选择“SVN Update”项，如下图所示：

点击“SVN Update”后会弹出窗口显示更新的进度，如下图所示：

Muchinfo SVN使用手册V1.0.0.1

若上述框中的有文件出现亮红，说明来自配置库的内容与你本地修改内容合并时出现了冲突，解决方法详见本文档1.3.11解决冲突。

1.3.3. 删除文件

选中要被删除的文件，右键选择“TortoiseSVN”的“Delete”项，如下图所示：

删除文件后，鼠标选中test文件夹右键选择“SVN Commit…”项进行提交，提交方式同增加文件的提交方式，提交后则将新文件从配置库中删除。最后在IE地址栏中输入/test验证“新文件”是否已经删除。

1.3.4. 修改文件

选中本地硬盘test文件夹，右键选择“TortoiseSVN”的“SVN Update”项更新本地文件，里面的文件都有特殊标识，如“江西空中充值项目”的标识显示为：

Muchinfo SVN使用手册V1.0.0.1

打开“江西空中充值项目”修改部分内容，保存后退出。“江西空中充值项目”图标显示为：

鼠标选中“江西空中充值项目”右键选择“SVN Commit”项提交，系统弹出如下信息框：

在Message栏中填写修改文件的注释（这时可以点击“Recent messages”按钮查看本文档以前版本的注释信息），点击“OK”按钮进行提交，提交方式同增加文件的提交方式。在提交前可以在上图中双击“江西空中充值项目”文本文件查看既要提交的修改内容（比较上一版本所修改的内容，此步骤可直接在本地磁盘中通过右键选择“TortoiseSVN”的“Check for

modifications”或“Diff”项实现）。

提交文件前，也可通过选中“江西空中充值项目”右键进行相关操作，如下图所示：

1.3.5. 比较版本差异

 本地更改内容与更改前内容比较

如果你想看到你本地的“江西空中充值项目”文本内容有哪些更改，鼠标选中“江西空中充值项目” 文本右键选择“TortoiseSVN”的“Diff”项，系统弹出差异内容。

 本地更改内容与历史版本的比较

如果你想查看你本地的“江西空中充值项目”文本内容与其历史版本之间的差异，鼠标选中“江西空中充值项目” 文本右键选择“TortoiseSVN”的“Show log”项显示日志对话框，在日志对话框选择要比较的历史版本，后右键选择“Compare with working copy”项，如下图所示：

Muchinfo SVN使用手册V1.0.0.1

点击后，系统弹出差异内容，如下图所示：

 两个历史版本的比较

如果你要查看“江西空中充值项目”文本任意已提交的两个历史版本之间的差异，在上

Muchinfo SVN使用手册V1.0.0.1

述日志对话框中选择你要比较的两个版本，右键选择“Compare revisions”项，系统弹出差异内容。

 与另外一个分支/标签之间的比较

如果你想查看“江西空中充值项目”文本的某一分支(假如你在主线上开发)有哪些修改，选“江西空中充值项目”文本文件的同时按住Shift键，后右键选择“TortoiseSVN”的“Diff

with URL”。如下图所示：

在弹出的对话框中输入要比较的URL地址。如下图所示：

点击“OK”按钮后，系统弹出差异内容。

 比较两个文件差异

如果你想查看同一目录下两个没有关系的文件差异，选中这两个文件，右键选择“TortoiseSVN”的“Diff”项，系统弹出这两个文件的差异内容。

 比较两个文件夹差异

如果你想查看两个不同的文件夹之间的差异，需使用版本库浏览器打开此目录，选中要比较的两个文件夹，右键选择“Compare revisions”项，如下图所示：

单击后系统弹出这两个文件夹的修改列表，如下图所示：

可以选择上图中单个文件右键进行相关操作。

 比较两个图像差异

如果你想查看两个不同的图像之间的差异，选中要比较的两个图像或者选中被修改的图像，右键选择“TortoiseSVN”的“Diff”项，系统弹出这两个图像的差异内容。如下图所示：

Muchinfo SVN使用手册V1.0.0.1

1.3.6. 撤销更改

在修改了某些文件后（文件未上传到配置库），需要返回到修改前的状态，则选中文件夹test右键选择“TortoiseSVN”的“”项进行撤销，本地硬盘上的文件将恢复到修改前的内容，修改的内容将被删除。

1.3.7. 锁定和解锁

当项目需要时可以在你本地硬盘中将你迁出的内容进行锁定，选中要被锁定的文件右键选择“TortoiseSVN”的“”项进行锁定（锁定后他人将无法修改此文件），系统弹出锁定信息框，如下图所示：

点击“OK”按钮即可将“江西空中充值项目”文本文件锁定，锁定后显示如下：

解锁时选中被锁定的文件右键选择“TortoiseSVN”的“Release lock”项进行解锁。

1.3.8. 重命名文件

鼠标选中“江西空中充值项目”文本文件右键选择“TortoiseSVN”的“”项，系统弹出如下信息框：

在New name框中输入新文件名后点击“OK”按钮，将出现重命名后的文件，原文件被删除，将它们提交后重命名生效。

Muchinfo SVN使用手册V1.0.0.1

1.3.9. 获取历史文件

 查看历史文件

鼠标选中文件夹test右键选择“TortoiseSVN”的“Show log”项，系统弹出此路径下的所有文件版本信息，如下图所示：

此时也可双击“江西空中充值项目”文本文件查看修改的内容（比较上一版本所修改的内容）。

 获取历史文件

鼠标选中文件夹test右键选择“TortoiseSVN”的“Update to revision”项，后系统提示需要选择下载的版本，如下图所示：

“Revision”栏中“HEAD revision”为最新版本，“Revision”手工输入版本号，也可点击“Show

log”按钮选择需要的版本内容，选择版本19后，点击“OK”按钮，系统弹出如上信息框：

点击“OK”按钮，系统开始下载文件，下载完毕后提示框如下：

点击“OK”按钮，结束本次操作。

1.3.10. 检查冲突

在提交你修改的文件到配置库前，可先检查本地修改的内容是否与配置库中的内容冲突。选中修改的文件或文件夹，右键选择“TortoiseSVN”的“Check for modifications”项，将显示所有被修改的内容，检查“江西空中充值项目”文本如下图所示：

Muchinfo SVN使用手册V1.0.0.1

点击上图中“Check repository”按钮，后双击“江西空中充值项目”文本或右键处理，则显示出此文件在配置库中的改动内容和你本地的改动内容，判断是否存在冲突，如下图所示：

上图表明存在冲突，可以直接右键在上图中进行修改解决冲突（如上图灰色所示），或者将发生冲突的文件拖到文本编辑器或者其它应用程序中进行修改，也可选中发生冲突的文件右键选择“Open”或“Open with…”打开文件进行修改解决冲突。

1.3.11. 解决冲突

当你Update“江西空中充值项目”文本文件出现冲突时，Subversion会产生三个文件：“江西空中充值项目.”；“江西空中充值项目.txt.r19” ；“江西空中充值项目.txt.r20”，如下图所示：

在“江西空中充值项目”文本文件冲突的内容中，冲突的地方将使用“<<<<<<<”标示出来，查找以字符串<<<<<<<开头的行，人为进行合并的取舍，如下图所示：

其中，前的内容为本地硬盘中文件的内容，后的内容为配置库中文件的内容，需要手工修改解决这两个内容的不同之处。

手工修改冲突的内容后，右键选择“TortoiseSVN”的“Resolved…”项，删除冲突所产生三个文件（也可手动删除这三个文件），如下图所示：

Muchinfo SVN使用手册V1.0.0.1

删除后进行提交，解决冲突。

1.3.12. 忽略无需版本控制的文件

在你给配置库中提交内容时，会有一些文件和目录不需要进行版本控制，只需要在你本地硬盘保存即可，这可能包括一些由编译器生成的文件，如*.obj,*.lst等。此时可采用添加相应文件到该项目的忽略列表的方法解决。

选中本地硬盘中无需提交到配置库的文件（此文件在本地硬盘的父目录是处于版本控制下的），右键选择“TortoiseSVN”的“Add to ignore list”项，如下图所示：

点击“Add to ignore list”项中的江西空中充值项目.代表只忽略这一个文件，若点击*.bak代表忽略所有具有*.bak后缀的文件。

如果你同时选择多种文件进行忽略时，就没有子菜单了，仅显示待忽略的个数，如

点击后系统弹出如下信息框：

1.3.13. 去除SVN标志

选中需要取消SVN标记（脱离版本控制）的文件夹（其子文件夹也要取消相应标记）右键选择“TortoiseSVN”的“Export…”项，系统弹出导出路径的信息框，如下图所示：

Muchinfo SVN使用手册V1.0.0.1

选定你要导出的路径，若选择E盘则会保存一份干净的文件到E盘。

选择上图中的“Export unversioned files too”复选框表示将本地不处于版本控制下的文件一起导出。

也可将每个文件目录下（包括子文件目录下）的.svn文件删除解决此问题。

1.3.14. 查看文件每行的修改信息

如果需要精确地知道谁修改了文件的哪一行，选中文件右键选择“TortoiseSVN”的“Blame…”项，系统提示需要选择的版本范围，如下图所示：

在上图中输入起始版本和目标版本，点击“OK”按钮后，系统弹出如下信息框：

上图中显示文本内容、版本和修改人。

Muchinfo SVN使用手册V1.0.0.1

1.3.15. 重置访问路径

在你的本地硬盘选中已从配置库中获取的文件，右键选择“TortoiseSVN”的“Switch…”项，系统提示需要选择配置库中的路径，如下图所示：

点击“OK”按钮，则将你选中的文件夹内容更新为你输入的路径中的内容，转换访问路径。

1.3.16. 本地路径转换

举例说明，选中本地jxmtp2_c文件夹，右键选择“TortoiseSVN”的“”项，在弹出框中输入需转换的路径，如/svn/jxmtp2_c，如图，点击“OK”按钮即可将本地jxmtp2_c文件夹的路径从/svn/jxmtp2_c转换到/svn/jxmtp2_c。此转换无需重新下载即可实现路径转换。

1.4. 浏览版本库

本文档1.3维护工作文件中的操作也可在版本库浏览器中进行，此时属于在服务端直接操作。在本地任意位置右键选择“TortoiseSVN”的“Repo-browser”项，如下图所示：

点击后系统弹出如下信息框：

在上图URL框中输入你要访问的路径，点击“OK”按钮后显示此路径下的所有内容，如下图所示：

选中某一文件右键进行相关操作，如上图灰色所示。

如果要在版本库浏览器中移动一个文件，只用左键拖它到要去的位置。

如果要复制/移动一个文件或文件夹到一个新的位置并重命名，可以右键拖或者按住右键拖文件，而不用左键拖。这样，会显示对话框来为该文件或文件夹重命名。

1.5. 建立标签

鼠标选中主线目录右键选择“TortoiseSVN”的“Branch/tag…”项，系统弹出有关标签路径的信息，如下图所示：

在To URL栏中输入标签目录，如/test/空中充值项目/标签/V1.0.0.0（输入的V1.0.0.0可自动生成，无需事先建立V1.0.0.0文件夹），点击“OK”按钮建立V1.0.0.0版本标签。

1.6. 建立分支

 建立分支

Muchinfo SVN使用手册V1.0.0.1

分支建立方法和标签建立方法相同。

 合并分支

首先保证你在分支上的修改已经全部提交。

鼠标选中主线文件夹右键选择“TortoiseSVN”的“Merge…”项，系统弹出有关分支合并的信息，如下图所示：

在From框中选择URL(如/test/空中充值项目/分支)点击show log选择起始版本。

在To框中选择URL（与From框中路径相同）和版本号（需合并的版本，若是最新版本可直接选择HEAD Revision）。

点击“Merge”后，即完成将分支修改内容合并到主线目录的工作。

最下面的按钮介绍：

“Diff”显示出所有发生变化的文件列表，双击具体文件可以查看分支文件与主线文件的区别。

“Unified diff”显示分支和主线两版本树之间所有文件的内容的变化。

“Dry run”能显示真正合并时的状态信息，但并没有做任何的合并操作。

 查看版本分支图

选中要查看的文件，右键选择“TortoiseSVN”的“Revision graph”项，系统弹出有关版本分支的结构图，如下图所示：

1.7. 清除用户名等信息

当你的SVN客户端记录了你访问配置库的用户名和密码后，需要清除所记录的内容。右键选择“TortoiseSVN”的“Settings”项，系统弹出有关设置的信息框，如下图所示：

Muchinfo SVN使用手册V1.0.0.1

选中上图中的“Saved Data”项在右侧显示框中点击“Authentication data”的“Clear”按钮清除用户名和密码。

1.8. 统计信息

选中本地已迁出的文件或者浏览版本库，右键选择“TortoiseSVN”的“Show log”项，系统弹出日志对话框，如下：

Muchinfo SVN使用手册V1.0.0.1

点击上图中的“Statistics”按钮进行信息统计，系统弹出以下信息框：

在上图中可选择依据日期或依据作者进行统计。

依日期统计后如下图所示：

Muchinfo SVN使用手册V1.0.0.1

依作者统计后如下图所示：

Muchinfo SVN使用手册V1.0.0.1

1.9. SVN数据同步

中英文路径都适合（如果是中文路径，则需要从IE中把乱码路径拷贝到Value中）

要实现在“localhost:2003/seaway/抚州水力”目录下共享“/seaway/快易营业点平台/工程文档”的内容，只需要在本地“/seaway/抚州水力”上设置svn:externals属性，

1. 选中“抚州水力”目录，右键TortoiseSVN->Properties

2. 在Properties对话框里点Add

3. 在Add properties界面属性下拉框选svn:externals，输入属性值。在Property value中添加external对象“工程文档”和被同步的路径，如图：

注意：复选框Apply property recursively是“是否要在抚州水力的每个子目录下面都共享添加/seaway/快易营业点平台/工程文档”的内容。如果选中，抚州水力的每个子目录下都会自动增加工程文档目录。

增加该属性后，你本地文件为已修改状态，先Update更新配置库中的最新内容，后提交修改到配置库中，在配置库生效。

加该属性后，再更新抚州水力目录的时候，自动在抚州水力目录下建工程文档目录，并把“/seaway/快易营业点平台/工程文档”里面的内容保存到“localhost:2003/seaway/抚州水力/工程文档”里。如果更新“localhost:2003/seaway/抚州水力/工程文档”目录里文件的内容，做commit，对该文件的修改也会保存到“/seaway/快易营业点平台/工程文档”里面。

Muchinfo SVN使用手册V1.0.0.1

2. Visual Studio集成SVN

2.1. 安装VisualSVN

本文以为例。安装Visual Studio 2013.

菜单集成：

右键菜单集成：

Muchinfo SVN使用手册V1.0.0.1

Pending Changes面板