svn使用教程及常见问题解决方案

使用教程转自：http://www.cnblogs.com/armyfai/p/3985660.html

SVN简介：

为什么要使用SVN？

程序员在编写程序的过程中，每个程序员都会生成很多不同的版本，这就需要程序员有效的管理代码，在需要的时候可以迅速，准确取出相应的版本。

Subversion是什么？

它是一个自由/开源的版本控制系统，一组文件存放在中心版本库，记录每一次文件和目录的修改，Subversion允许把数据恢复到早期版本，或是检查数据修改的历史，Subversion可以通过网络访问它的版本库，从而使用户在不同的电脑上进行操作。

一：SVN服务器搭建和使用。

1.     首先来下载和搭建SVN服务器,下载地址如下: http://subversion.apache.org/packages.html，进入网址后，滚动到浏览器最底部看到如下截图：

个人认为最好用VisualSVN server 服务端和 TortoiseSVN客户端搭配使用. 点开上面的VisualSVN连接,下载VisualSVN server,下载完成后双击安装，如下图：

点击Next下一步，如下：

然后再点击Next项，下一步，如下：

点击【Next】 如下：

Location是指VisualSVN Server的安装目录,Repositorys是指定你的版本库目录.Server Port指定一个端口,Use secure connection勾山表示使用安全连接,

点击Next,进入下一步,如下图:

再点击【Install】,进入如下安装图：

等待安装完成后，点击【next】，进入下一步：如下图

点击【Finish】即可完成安装。安装完成后,启动VisualSVN Server Manager,如图:

可以在窗口的右边看到版本库的一些信息,比如状态,日志,用户认证,版本库等.

要建立版本库,需要右键单击左边窗口的Repositores,如下图:

在弹出的右键菜单中选择Create New Repository或者新建->Repository:

进入下一步，如下图：

点击【下一步】，如下图：

点击【create】，如下图：

点击【Finish】即可完成基本创建。

  2. 需要建立用户和组，并且需要分配权限。

1. 在VisualSVN Server Manager窗口的左侧右键单击用户组,选择Create User或者新建->User,如图:

点击User后，进入如下图：

填写Username和password后，点击ok按钮后，进入如下图：

点击上面的【Add】按钮后，如下图

增加longen0707到用户中(如果有多个用户，操作一样)。

2 .   然后我们建立用户组,在VisualSVN Server Manager窗口的左侧右键单击用户组,选择Create Group或者新建->Group,如图:

点击【Group】按钮后，进入如下图：

在弹出窗口中填写Group name为Developers,然后点Add按钮,在弹出的窗口中选择Developer,加入到这个组,然后点Ok.

接下来我们需要给用户组设置权限，在MyRepository上单击右键,选择属性,如图:

在弹出的对话框中,选择Security选项卡,点击Add按钮,选中longen0707,然后添加进来,权限设置为Read/Write,如下图:

点击【确定】按钮即可。

二：客户端SVN安装。

1.首先我们需要下载 ”svn小乌龟”后，进行安装。比如我下载如下的：

安装完成后，比如在我的项目在qiandaun1中，我右键就可以看到如下：

说明snv已经安装成功了！

2：checkout项目文件。

新建或者进入目录下(比如qianduan1)，右键 --> Svn Checkout -->

其中URL我可以在SVN服务器获取到，我在myRepositories下右键新建文件

qianduan文件被建立，然后比如我这样右键 --> copy下

即可。

将复制的版本库URL粘贴上,如下图：

点击【ok】按钮后，就可以检索出来，如下：

如下图：

注意事项：

   .svn这个隐藏目录记录着两项关键信息：工作文件的基准版本和一个本地副本最后更新的时间戳，千万不要手动修改或者删除这个.svn隐藏目录和里面的文件!!,否则将会导致你本地的工作拷贝(静态试图)被破坏，无法再进行操作。

1)    TortoiseSVN图标介绍

一个新检出的工作复本使用绿色的对勾重载，表示Subversion状态正常。

在你开始编辑一个文件之后，状态就变成了已修改，而图标重载已变成了红色感叹号。通过这种方式，你可以很容易地看出那些文件从你上次更新工作复本被修改过，且需要提交。

  如果在提交的过程中出现了冲突，图标就会变成了黄色感叹号。

加号告诉你有一个文件或者目录已经被计划加入到版本控制中。

2)     TortoiseSVN Client基础操作:

1. SVN检出(SVN Checkout)

在文件夹或者目录下单击右键 –> 选择SVN检出，如下图所示

点击后，在弹开窗口的版本库url框中输入版本库的目录地址，然后点击确定，如下图

再点击ok按钮后，如下图：

在弹出的对话框中输入用户名和密码，验证成功后，项目文件开始从远程服务器下载到本地工作目录中。

点击ok按钮后，即可获取完成，如下图所示：

 2.  增加(Add)

在test项目文件下，新建一个b.txt文件，提交到版本库的方法如下2种：

1. 先提到变更列表中，再commit到配置库中，选择新增文件，右键SVN菜单执行“Add“操作提交到”变更列表中”，然后右键SVN菜单执行”SVN Commit”提交到版本库中。

2. 不提交到变更列表中，而是直接commit配置库中，选择该文件，右键svn菜单执行”SVN Commit”操作。

  3.  删除(Delete)

如果被删除的文件还未入版本库，则可以直接使用操作系统的删除操作删除该文件。

如果被删除的文件已入版本库，则删除的方法如下：

1. 选择被删除文件，右键svn菜单执行”delete”操作，然后选择被删除文件的父目录，右键svn菜单执行”SVN Commit”.

使用操作系统的删除操作删除该文件，然后选择被删除文件的父目录，右键svn菜单执行”SVN Commit”,在变更列表中选择被删除的文件。如下图：

 4.  改名(Rename)

修改文件名，选中需要重命名的文件或文件夹，然后右键“TortoiseSVNàRename“，在弹出的对话框中输入新名称，点击”ok”按钮，并将修改文件名后的文件或文件夹通过 “SVN Commit”提交到SVN服务器上。

 5.  SVN还原(SVN Revert)

右击想要回退的文件或者文件夹，在TortoiseSVN弹出菜单中选择”Update to reversion…” 然后会弹出一个窗口，如下：

比如说我们要回退到第10个版本只需要在Revision中填写相应的版本号，然后点击ok即可。

6.  检查更新(Check for modifications)

此功能可以显示你所做的修改有哪些还没有提交的，此功能不光能看到对文件的修改变化，所有的变化都能看到，包括增加文件或者目录，删除文件或者目录，移动文件或者目录等，如果你点击了检查版本库，那你还可以看到版本库里的改动，既别人提交了哪些文件的改动，你还没更新到本地，如下：

7.  SVN更新(SVN Update)

更新本地代码与SVN服务器上最新的版本一致，只要在需要更新的文件夹上点击右键或者在文件下空白处点击右键，选择”SVN Update” (获取指定版本中的内容，点击右键执行SVN菜单中的“Update to reversion“)，就可以了。

7.1 如何解决冲突文件

对于每个冲突的文件Subversion在你的目录下放置了三个文件：如下：

为什么会产生冲突代码呢？原因很简单就是因为不同的人，同时修改了同一个文件的同一个地方，这时候，他提交了，我没有提交，我就提交不了，这个时候我们要进行先更新，然后在进行提交即可，那如果产生冲突，会生成如上3个文件。

解决方案如下：

首先我们可以看下1.txt代码如下：

<<<<<<< .mine

aaaasdf11222333 dderderder

=======

b>>>>>>> .r5

然后我去掉多余的代码，1.txt变成这样

aaaasdf11222333 dderderder

进行提交，还是提交不了，如下所示：

为什么？因为冲突会产生上面的三个文件，有上面3个文件存在肯定提交不了，这三个文件代码及解释如下：

1. 1.txt.mine 是冲突前自己的文件。可以看下内容如下：

aaaasdf11222333 dderderder

2.  1.txt.r4 是冲突前本地的版本文件

内容如下：aaaasdf11222333

3.  1.txt.r5  是别人赶在你之前提交的版本

内容如下： b

其中,<<<<<<<<.mine .....=======之间的代码是你自己的，而======......>>>>>>>.r5是别人与你冲突的代码部分

这样就不难理解为什么会产生冲突这种奇怪的东西了，因为你们修改的同一块代码，当然会产生冲突。

解决方案如下：

1. 假如我现在的1.txt中的冲突内容如下：

<<<<<<< .mine

6666666666666600000

=======

66666666666aaaaaaaaaa666

>>>>>>> .r16
    前面说过  <<<<<<< .mine …… =======

……之间的代码是我未产生冲突之前修改的代码，

    ======= ………>>>>>>> .r16 这中间……的代码是别人与我冲突代码的部分，从上面的代码可以看到 aaaaaaaaa是我同事新增的 ,00000是我后增加的。

1. 使用revert(回滚)操作，该操作表示用户放弃自己的更新代码，然后直接提交，这个时候你的代码就会使服务器上最新的代码，即A用户提交的新代码，你的代码不会被提交，如下所示：

   点击ok按钮后 可以看到其他三个文件都自动删掉了，1.txt代码变成如下代码：

   66666666666aaaaaaaaaa666

   也就是a用户提交的代码，我自己更新的代码需要自己动手复制进去即可提交commit。

2. 假如我现在3.txt产生冲突代码如下：

   <<<<<<< .mine

   333333338888888888888=======

   3333cccccccccc3333>>>>>>> .r16

   通过第一点我们知道，333333338888888888888这个内容是我修改后，未产生冲突之前的内容，3333cccccccccc3333这个代码是A用户提交的代码，从上面得知 A用户新增内容是ccccccc，而我新增的内容是8888888。

   那么第二种解决方法如下：

选择文件->右键Editconficts：这种方法需要冲突双方经过协商之后将代码更改统一之后再提交。不仅解决了冲突而且还保证了代码是正确的，因为只有一方的代码被提交.

如上图所示，红色的部分是冲突代码：theirs表示当前服务器端最新的代码，Mine表示自己修改后的代码，Merged表示合并后的代码。点击红色后右键选择：use this text block就可以将该部分代码作为合并后的代码

接下来再说说由于冲突导致重要代码被覆盖的情况。冲突发生时如果采取的措施不对可能会导致部分代码丢失，如果想要还原之前的代码也很容易。

选择文件->右键选择show log在这里面你可以看见之前提交的所有版本，找到你想要恢复的版本右键选择revert to this version 就可以恢复了.

SVN提交(SVN Commit)

Svn的提交是将在工作空间做的修改进行提交，包括文件内容的修改，文件或目录的添加，删除，命名，移动等操作。如下图所示:

8.   显示日志(Show log)

通过此功能可以查到谁，什么时候，对那个目录下的那些文件进行了那些操作，如下图：

9.  版本库浏览(Repo-browser)

此功能是用来浏览需要查看的资料库，在本地文件夹下点击右键，选择TortoiseSVNàRepo-browser,在弹出的对话框中输入资料库地址，再输入用户名和密码，就能查看到你需要查看到版本库的内容，在这你还能看到那些文件被谁锁定了，如下图：

三： 创建分支合并相互操作

项目中为何要创建分支，及合并？

比如我现在项目所有的文件放在主干上(trunk)中，由于需求的变更，需要增加新的需求，但是我们主干上还要继续往下开发，在此我们可以新建一个分支，来做增加新的需求那一块，主干上继续开发，等分支上代码没有问题的时候，再合并到主干上来。

创建分支的最大的目的就是跟主线进行并行开发时候不影响主线的开发。

   如何操作？

      假如我本地新建一个文件夹test下有2个文件夹trunk(存放主干上的代码)和branch(存放分支上的代码)，如下所示：

一：先提取主干上的代码。

点击trunk --> 鼠标右键 --> 点击SVN Checkout --> 弹出一个对话框，如下图所示：

其中上面的URL是从服务器VisualSVN Server上获取的，如下所示：

直接右键qianduan3 --> Copy URL to Clipboard 即可。

其中qianduan3项目有如下文件，如下图所示：

最后点击上面的checkout按钮后，就可以在主干上把代码从远程服务器上获取到，如下所示：

二：新建分支

  从trunk（主干上）创建分支(branch)步骤如下：

1. 右键trunk --> branch/Tag 如下图：

在弹出的对话框如下图：

点击ok按钮后，就可以在VisualSVN Serval服务器上新增newBranch，是从如上服务器qianduan3上的文件拷贝一份的，如下所示：

现在我们可以再来看看本地branch文件夹了，我现在直接进入branch文件下，右键 --> Chenckout下，就可以把newBranch下的所有文件提取出来了，如下所示：

点击ok按钮就可以把文件提取出来了，如下图所示：

分支目前建立在svn的服务器端，本地并没有更新，对本地branch文件夹 右键--> update即可，就可以更新到分支代码，如下所示：

四：合并分支到主干上

比如我现在对branch分支上新增3.txt文件，然后提交上去，如下所示：

我现在想把分支上的代码3.txt合并到主干上trunk，现在要怎么合并呢？步骤如下：

1. 回到我们刚刚的主干（trunk）文件夹下，鼠标右键该文件夹 --> TortoiseSVN --> Merge 如下图所示：

在弹出的窗口，如下图所示：

接着点击【Next】下一步，如下图所示：

再接着【Next】下一步，如下图所示：

就可以看到主干trunk上多加了一个3.txt，就是从分支上合并过来的。

五：合并主干到分支。

如果主干上有一些更新，比如说jar包更新等等，那么这些要更新到分支上去，如何操作呢？比如我现在在主干上新建一个4.txt文件，比如如下：

我现在的分支上目录如下：

现在是想把主干上的4.txt合并到分支上来，要如何操作？

步骤如下，还是和刚刚操作类似.

1. 我们在分支点击branch --> 右键TortoiseSVN --> Merge 如下图所示：

在弹出新窗口后，如下图所示：

接着点击【Next】下一步，如下图所示：

继续下一步，如下图：

最后直接merge，就可以看到分支branch上也有主干上的4.txt文件了，也就是说，合并主干到分支上也是可以的，如下图所示：

二、关于主干更新到分支，避免主干覆盖分支的问题：http://blog.sina.com.cn/s/blog_5f54f0be0101f04y.html

一个大项目在开发中可能会拆分成几个小项目，分别分去，同时共通的部分再由人做，做完后再统一合并。同时，在开发中，共通的部分修改后，其它人要保持同步。

这种情况反应到SVN的分支/合并功能上，再贴切不过了。

SVN可以为一个版本库中的内容(主干)建立一个分支.分支和主干完全独立，就相当于把代码再复制一份，重新添加到版本库中。但SVN提供另一个功能，就是把主干做出的修改合并到分支中，以及把分支修改的内容合并到主干中。当然，我们也可以把主干的版本库的路径切换到分支上，然后更新，来实现把分支的修改更新到主干；以及修改分支路径来同步主干的修改。但过程复杂，还容易出错。

SVN 的分支功能还提供一些合并的测试，可以在不改动版本路径的情况下完成上面的需求。

 

示例:

 

1.将一个整项目建一个分支.

 

 

 

建立时要注意：

 

1.当前复制源,即专业术语中的 "主干(truck)"

2.分支存放的位置. 当然，分支也是在SVN版本库中.

3.写上日志.这个大家应该懂的.

4.是否把主干的路径切换到分支.如果勾选了，建立分支后，在主干里做出的修改并提交后，更新会提交到分支上。主干的版本源内容不会变.

 

这时我们看一下 trunk 目录的属性，可以看到它的路径已经变成: /calc/branches/my-calc-branch 了。

 

为了避免产生困惑。以及失误。在建立的时候不要勾上 "切换到分支" 的选项。如果勾上了，我们还是切换回去:

 

注意:

 

1.主干的目录

2.版本库源路径

这时你便可以在 /calc/branches/my-calc-branch 分支上开发新的功能，且不会影响到其他成员开发或维护主干的内容。

 

2.合并主干的变更

也许过了一段时间，原本的 /calc/trunk 主干可能已经有其他成员陆续修正了一些 Bugs，但这时你的分支 /calc/branches/my-calc-branch 就可以直接套用主干 ( /calc/trunk ) 的更新，除了避免重复的工作外 ，也可以避免版本的冲突，因为多人改同样的文件可能发生冲突。

 

经常將 开发主干 ( /calc/trunk ) 的变更透过 svn merge 合并至 分支 ( /calc/branches/my-calc-branch ) 是一个非常好的习惯，这样才不会让你脱离主干(trunk) 过久而导致将分支 ( /calc/branches/my-calc-branch ) 合并回 主干 ( /calc/trunk ) 时发生许多冲突。

 

从主干 ( /calc/trunk ) 合并至分支 ( /calc/branches/my-calc-branch ) 通常选第 1 个，也就是 [Merge a range of revisions]

 

注意.我们是在分支上使用的 Merge 功能.因为是要在分支上应用主干的更新.

 

在 Merge 的窗口有以下注意事項：

 

1.合并的来源，由于我们打算从主干 ( /calc/trunk ) 合并至分支 ( /calc/branches/my-calc-branch )，所以合并的來源要选 /calc/trunk 才对！

2.合并的结果会直接与目前「工作目录」(Working Copy) 做比对，并修改目前工作目录中的所有文件。因此建议在做合并之前可以将所有尚未 commit 的档案先 commit 到版本库，避免不必要的冲突事件发生。

 

在正式进行合并(Merge)之前，建议先执行 Test merge 看看是否会发生什么事!

 

若无异状则可直接按下 [Merge] 按钮进行合并动作，这时从 主干 ( /calc/trunk ) 分支出来的到目前工作目录的版本就会做个比较，然后直接套用变更到你现有的文件、目录或属性里。

 

在合并之后如果没有发生冲突，不代表真的没冲突，所以必须再次对原始码做出验证后才能 commit 进版本库，建议可参考以下流程：

 

1.将项目进行建置(Build)

2.如果没问题再对项目进行单元测试(Unit Testing)或手动测试(Manual Testing)

3.如果都没问题再 commit 目前合并无误的版本到版本库！

 

 

3.合并分支到主干

最后我们的 my-calc-branch 分支已经将新功能开发完成且测试无误，所以要将 分支 ( /calc/branches/my-calc-branch ) 的最终版本合并回 主干 ( /calc/trunk )，这时的手续如下：

 

从 分支 ( /calc/branches/my-calc-branch ) 合并回 主干 ( /calc/trunk ) 通常选第 2 个，而特别选择 [Reintegrate a branch] 这个选项是很重要的，因为这有以下好处：

 

1.让 Subversion 能知道 主干 ( /calc/trunk ) 是从哪个分支、哪些版本合并进来的

2.有效节省 Subversion Repository (SVN储存库) 的空间，因为不用重复储存分支的所有变更信息

3.可以产生 Revision graph 得知项目开发的分支状况

 

一样可以先 测试合并(Test merge) 再正式进行 合并(Merge)

 

合并完后再将变更 commit 到版本库

 

4.删除使用完毕的分支

当 分支 ( /calc/branches/my-calc-branch ) 合并回 主干 ( /calc/trunk ) 并 commit 了之后，该分支就没用了，该分支如果未来不再更新或继续开发，Subversion 也不会继续追踪这个分支的变更 (因为之前已经 Reintegrate 过了)，建议将该分支删除。