本文目录

• 一、SVN概述

• 二、SVN服务器搭建和使用：

• 三、使用svn客户端功能

• 四、使用注意事项 

一，SVN概述

* 什么是SVN（Subversion）?

  答：简单的说，您可以把SVN当成您的备份服务器，更好的是，他可以帮您记住每次上传到这个服务器的档案内容。并且自动的赋予每次的变更一个版本。
        通常，我们称用来存放上传档案的地方就做Repository。用中文来说，有点像是档案仓库的意思。不过，通常我们还是使用Repository这个名词。
基本上，第一次我们需要有一个新增(add)档案的动作，将想要备份的档案放到Repository上面。日后，当您有任何修改时，都可以上传到Repository上面，上传已经存在且修改过的档案就叫做commit，也就是提交修改给SVN server的意思。针对每次的commit，SVN server都会赋予他一个新的版本。同时，也会把每次上传的时间记录下来。日后，因为某些因素，如果您需要从Repository下载曾经提交的档案。您可以直接选择取得最新的版本，也可以取得任何一个之前的版本。如果忘记了版本，还是可以靠记忆尝试取得某个日期的版本。

* 版本库布局

1. trunk主干

   trunk就是开发的主线，一般项目都是导入到主线来开发的。

2. branches分支

   branches一般是trunk某个版本的拷贝，如果你想在某一段时间单独对某个功能进行开发，而不像和其它功能混在一起，这时候branches是一个很好用的方式。你不会想 在trunk里一直开发这个功能，不提交，直到开发完成吧。一般也会合并的trunk中的。

3. tags标签

    tags就是标签，顾名思义，就是某个版本的记录啦，就好像看一本厚厚的，看到哪一页了，做个记号，方便以后查阅。 

迭代开发时，在某个版本发布应用，为了做个记录，这时候打个tag很实用。发布后，线上出现了一个bug，可以根据这个tag进行修复再发版本。

二，SVN服务器搭建和使用：

*   创建代码仓库（用来存储客户端所上传的代码)

 第一步：我们先在文稿目录（~/Documents）下创建新建一个 svn 目录，后面我们会把多个仓库目录都放在这里面。
      

                                                                                                               图一
      

                                                                                                               图二

     第二步：打开终端，执行如下命令，创建一个名为 TestCode的仓库。

                                                                                                              图三

仓库里的目录结构如下
                                                  

                                                                                                              图四

*  配置用户权限

    在 svn/TestCode/conf 文件夹中有如下文件，我们需要分别进行修改。
                                                  

                                                                                                              图五
     第一步：打开svnserve.conf，将下列配置项前面的#和空格都去掉
                                                          

                                                                                                                图六

注意： anon-access = read代表匿名访问的时候是只读的，若改为anon-access = none代表禁止匿名访问，需要帐号密码才能访问
    第二步：修改 passwd。在 [users]下面添加帐号和密码（这里我配置了两个用户）
                                         

                                                                                                               图七

备注：# liangxiaolong（账号） = liangxiaolong（密码）

   第三步：打开authz，配置用户组和权限

         我们可以将在passwd里添加的用户分配到不同的用户组里，以后的话，就可以对不同用户组设置不同的权限，没有必要对每个用户进行单独设置权限。

         在[groups]下面添加组名和用户名，多个用户之间用逗号(,)隔开

         说明mj和jj都是属于topgroup这个组的，接下来再进行权限配置。

         使用[/]代表svn服务器中的所有资源库

         上面的配置说明topgroup这个组中的所有用户对所有资源库都有读写(rw)权限，组名前面要用@

          如果是用户名，不用加@，比如mj这个用户有读写权限

         而topgroup分组的用户只有对 code1 有读写权限。

 * 启动svn服务器

      前面配置了这么多，最关键还是看能否正常启动服务器，若启动不来，前面做再多工作也是徒劳。
在终端输入下列指令：

或者输入：

没有任何提示就说明启动成功了

* 停止svn服务器

三、使用svn客户端功能

以下是一些常用命令

1、从本地导入代码到服务器(第一次初始化导入)

在终端中输入

 svn import /Users/apple/Documents/eclipse_workspace/weibo svn://localhost/mycode/weibo --username=mj --password=123 -m "初始化导入"

指令的意思：将/Users/apple/Documents/eclipse_workspace/weibo中的所有内容，上传到服务器mycode仓库的weibo目录下，后面双引号中的"初始化导入"是注释

2、从服务器端下载代码到客户端本地

在终端中输入

指令的意思：将服务器中mycode仓库的内容下载到/Users/apple/Documents/code目录中
简写：

注意：
 * 如果不带--password 参数传输密码的话，会提示输入密码，建议不要用明文的--password 选项。
 * 其中 username 与 password前是两个短线，不是一个。
 * 不指定本地目录全路径，则检出到当前目录下。
3.提交更改过的代码到服务器

在步骤2中已经将服务器端的代码都下载到/Users/apple/Documents/code目录中，现在修改下里面的一些代码，然后提交这些修改到服务器

1> 打开终端，先定位到/Users/apple/Documents/code目录，输入：cd /Users/apple/Documents/code

2> 输入提交指令：svn commit -m "修改了main.m文件"

这个指令会将/Users/apple/Documents/code下的所有修改都同步到服务器端，假如这次我只修改了main.文件

可以看到终端的打印信息：

必须带上-m参数，参数可以为空，但是必须写上-m
例子：
svn commit -m “提交当前目录下的全部在版本控制下的文件“ * ＜－ 注意这个*表示全部文件
svn commit -m “提交我的测试用test.php“ test.php
svn commit -m “提交我的测试用test.php“ -N --no-unlock test.php ＜－ 保持锁就用–no-unlock开关
svn ci -m “提交当前目录下的全部在版本控制下的文件“ * ＜－ 注意这个*表示全部文件
svn ci -m “提交我的测试用test.php“ test.php
svn ci -m “提交我的测试用test.php“ -N --no-unlock test.php ＜－ 保持锁就用–no-unlock开关

4、导出(导出一个干净的不带.svn文件夹的目录树)
svn  export  [-r 版本号]  http://路径(目录或文件的全路径) [本地目录全路径]　--username　用户名
svn  export  [-r 版本号]  svn://路径(目录或文件的全路径) [本地目录全路径]　--username　用户名
svn  export  本地检出的(即带有.svn文件夹的)目录全路径  要导出的本地目录全路径
注：第一种从版本库导出干净工作目录树的形式是指定URL，
　　　如果指定了修订版本号，会导出相应的版本，
　　　如果没有指定修订版本，则会导出最新的，导出到指定位置。
　　　如果省略 本地目录全路径，URL的最后一部分会作为本地目录的名字。
　　第二种形式是指定 本地检出的目录全路径 到 要导出的本地目录全路径，所有的本地修改将会保留，
　　　但是不在版本控制下(即没提交的新文件，因为.svn文件夹里没有与之相关的信息记录)的文件不会拷贝。
例子：
svn export svn://localhost/测试工具 /home/testtools --username wzhnsc
svn export svn://localhost/test/testapp --username wzhnsc
svn export /home/testapp /home/testtools
5、添加新文件 

注：告诉SVN服务器要添加文件了，还要用svn commint -m真实的上传上去！
例子：
svn add test.php ＜－ 添加test.php 
svn commit -m “添加我的测试用test.php“ test.php
svn add *.php ＜－ 添加当前目录下所有的php文件
svn commit -m “添加我的测试用全部php文件“ *.php

6、更新文件

例子：
svn update ＜－ 后面没有目录，默认将当前目录以及子目录下的所有文件都更新到最新版本
svn update -r 200 test.cpp ＜－ 将版本库中的文件 test.cpp 还原到修正版本（revision）200
svn update test.php ＜－ 更新与版本库同步。
　　　　　　　　　　　 提交的时候提示过期冲突，需要先 update 修改文件，
　　　　　　　　　　　 然后清除svn resolved，最后再提交commit。
7、删除文件

例子：
svn delete svn://localhost/testapp/test.php -m “删除测试文件test.php”
推荐如下操作：

8、加锁/解锁 

例子：
svn lock -m “锁信测试用test.php文件“ test.php 
svn unlock test.php
9、比较差异 

例子：
svn diff test.php   ＜－将修改的文件与基础版本比较
svn diff -r 200:201 test.php ＜－ 对 修正版本号200 和 修正版本号201 比较差异
10、查看文件或者目录状态

注：svn status、svn diff和 svn revert这三条命令在没有网络的情况下也可以执行的，
　　原因是svn在本地的.svn中保留了本地版本的原始拷贝。 
11、查看日志

例子：
svn log test.php＜－ 显示这个文件的所有修改记录，及其版本号的变化 
12、查看文件详细信息

例子：
svn info test.php
13、SVN 帮助

14、查看版本库下的文件和目录列表 

例子：

15、创建纳入版本控制下的新目录

例子：

注：添加完子目录后，一定要回到根目录更新一下，不然在该目录下提交文件会提示“提交失败”

注：如果手工在checkout出来的目录里创建了一个新文件夹newsubdir，
　　再用svn mkdir newsubdir命令后，
      SVN会提示：
　　svn: 尝试用 “svn add”或 “svn add --non-recursive”代替？
　　svn: 无法创建目录“hello”: 文件已经存在
　　此时，用如下命令解决：

　　在进入这个newsubdir文件夹，用ls -a查看它下面的全部目录与文件，会发现多了：.svn目录
　　再用 svn mkdir -m "添hello功能模块文件" svn://localhost/test/newdir/newsubdir 命令，
　　SVN提示：
　　svn: File already exists: filesystem '/data/svnroot/test/db', transaction '4541-1',
　　path '/newdir/newsubdir '
16、恢复本地修改 

注意: 本子命令不会存取网络，并且会解除冲突的状况。但是它不会恢复被删除的目录。
例子：

17、把工作拷贝更新到别的URL 

例子：

18、解决冲突 

例子：

如果你在更新时得到冲突，你的工作拷贝会产生三个新的文件：
$ ls
foo.c
foo.c.mine
foo.c.r30
foo.c.r31
当你解决了foo.c的冲突，并且准备提交，运行svn resolved让你的工作拷贝知道你已经完成了所有事情。
你可以仅仅删除冲突的文件并且提交，但是svn resolved除了删除冲突文件，还修正了一些记录在工作拷贝管理区域的记录数据，所以我们推荐你使用这个命令。
19、不checkout而查看输出特定文件或URL的内容 

例子：

20、新建一个分支copy

21、合并内容到分支merge