本文目录
- 一、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 的仓库。
svnadmin create /Users/liangxiaolong/Documents/SVN/TestCode
图三
仓库里的目录结构如下
图四
* 配置用户权限
在 svn/TestCode/conf 文件夹中有如下文件，我们需要分别进行修改。
图五
第一步：打开svnserve.conf，将下列配置项前面的#和空格都去掉
图六
注意： anon-access = read代表匿名访问的时候是只读的，若改为anon-access = none代表禁止匿名访问，需要帐号密码才能访问
第二步：修改 passwd。在 [users]下面添加帐号和密码（这里我配置了两个用户）
图七
备注：# liangxiaolong（账号） = liangxiaolong（密码）
第三步：打开authz，配置用户组和权限
我们可以将在passwd里添加的用户分配到不同的用户组里，以后的话，就可以对不同用户组设置不同的权限，没有必要对每个用户进行单独设置权限。
在[groups]下面添加组名和用户名，多个用户之间用逗号(,)隔开
[groups]
topgroup=mj,jj
说明mj和jj都是属于topgroup这个组的，接下来再进行权限配置。
使用[/]代表svn服务器中的所有资源库
[/]
@topgroup=rw
上面的配置说明topgroup这个组中的所有用户对所有资源库都有读写(rw)权限，组名前面要用@
如果是用户名，不用加@，比如mj这个用户有读写权限
[/]
mj=rw
而topgroup分组的用户只有对 code1 有读写权限。
[/code1]
@topgroup = liangxiaolong
* 启动svn服务器
前面配置了这么多，最关键还是看能否正常启动服务器，若启动不来，前面做再多工作也是徒劳。
在终端输入下列指令：
svnserve -d -r /Users/liangxiaolong/Documents/SVN/
或者输入：
svnserve -d -r /Users/liangxiaolong/Documents/SVN/TestCode
没有任何提示就说明启动成功了
* 停止svn服务器
打开“活动监视器” 。搜索 svn，将进程强制退出即可。
三、使用svn客户端功能
以下是一些常用命令
1、从本地导入代码到服务器(第一次初始化导入)
在终端中输入
指令的意思：将/Users/apple/Documents/eclipse_workspace/weibo中的所有内容，上传到服务器mycode仓库的weibo目录下，后面双引号中的"初始化导入"是注释
2、从服务器端下载代码到客户端本地
在终端中输入
svn checkout svn://localhost/mycode --username=mj --password=123 /Users/apple/Documents/code
指令的意思：将服务器中mycode仓库的内容下载到/Users/apple/Documents/code目录中
简写：
svn co svn://localhost/mycode --username=mj --password=123 /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.文件
可以看到终端的打印信息：
Sending weibo/weibo/main.m Transmitting file data . Committed revision
必须带上-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 add 文件名
注：告诉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 修正版本 文件名 svn update 文件名
例子：
svn update ＜－ 后面没有目录，默认将当前目录以及子目录下的所有文件都更新到最新版本
svn update -r 200 test.cpp ＜－ 将版本库中的文件 test.cpp 还原到修正版本（revision）200
svn update test.php ＜－ 更新与版本库同步。
提交的时候提示过期冲突，需要先 update 修改文件，
然后清除svn resolved，最后再提交commit。
7、删除文件
svn delete svn://路径(目录或文件的全路径) -m “删除备注信息文本” 推荐如下操作： svn delete 文件名 svn ci -m “删除备注信息文本”
例子：
svn delete svn://localhost/testapp/test.php -m “删除测试文件test.php”
推荐如下操作：
svn delete test.php svn ci -m “删除测试文件test.php”
8、加锁/解锁
svn lock -m “加锁备注信息文本“ [--force] 文件名 svn unlock 文件名
例子：
svn lock -m “锁信测试用test.php文件“ test.php
svn unlock test.php
9、比较差异
svn diff 文件名 svn diff -r 修正版本号m:修正版本号n 文件名
例子：
svn diff test.php ＜－将修改的文件与基础版本比较
svn diff -r 200:201 test.php ＜－ 对 修正版本号200 和 修正版本号201 比较差异
10、查看文件或者目录状态
svn st 目录路径/名 svn status 目录路径/名＜－ 目录下的文件和子目录的状态，正常状态不显示 【?：不在svn的控制中； M：内容被修改；C：发生冲突； A：预定加入到版本库；K：被锁定】 svn -v 目录路径/名 svn status -v 目录路径/名＜－ 显示文件和子目录状态 【第一列保持相同，第二列显示工作版本号， 第三和第四列显示最后一次修改的版本号和修改人】
注：svn status、svn diff和 svn revert这三条命令在没有网络的情况下也可以执行的，
原因是svn在本地的.svn中保留了本地版本的原始拷贝。
11、查看日志
svn log 文件名
例子：
svn log test.php＜－ 显示这个文件的所有修改记录，及其版本号的变化
12、查看文件详细信息
svn info 文件名
例子：
svn info test.php
13、SVN 帮助
svn help ＜－ 全部功能选项 svn help ci ＜－ 具体功能的说明
14、查看版本库下的文件和目录列表
svn list svn://路径(目录或文件的全路径) svn ls svn://路径(目录或文件的全路径)
例子：
svn list svn://localhost/test svn ls svn://localhost/test ＜－ 显示svn://localhost/test目录下的所有属于版本库的文件和目录
15、创建纳入版本控制下的新目录
svn mkdir 目录名 svn mkdir -m "新增目录备注文本" http://目录全路径
例子：
svn mkdir newdir svn mkdir -m "Making a new dir." svn://localhost/test/newdir
注：添加完子目录后，一定要回到根目录更新一下，不然在该目录下提交文件会提示“提交失败”
svn update
注：如果手工在checkout出来的目录里创建了一个新文件夹newsubdir，
再用svn mkdir newsubdir命令后，
SVN会提示：
svn: 尝试用 “svn add”或 “svn add --non-recursive”代替？
svn: 无法创建目录“hello”: 文件已经存在
此时，用如下命令解决：
svn add --non-recursive newsubdir
在进入这个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、恢复本地修改
svn revert [--recursive] 文件名
注意: 本子命令不会存取网络，并且会解除冲突的状况。但是它不会恢复被删除的目录。
例子：
svn revert foo.c ＜－ 丢弃对一个文件的修改 svn revert --recursive . ＜－恢复一整个目录的文件，. 为当前目录
17、把工作拷贝更新到别的URL
svn switch http://目录全路径 本地目录全路径
例子：
svn switch http://localhost/test/456 . ＜－ (原为123的分支)当前所在目录分支到localhost/test/456
18、解决冲突
svn resolved [本地目录全路径]
例子：
$ svn update C foo.c Updated to revision 31.
如果你在更新时得到冲突，你的工作拷贝会产生三个新的文件：
$ ls
foo.c
foo.c.mine
foo.c.r30
foo.c.r31
当你解决了foo.c的冲突，并且准备提交，运行svn resolved让你的工作拷贝知道你已经完成了所有事情。
你可以仅仅删除冲突的文件并且提交，但是svn resolved除了删除冲突文件，还修正了一些记录在工作拷贝管理区域的记录数据，所以我们推荐你使用这个命令。
19、不checkout而查看输出特定文件或URL的内容
svn cat http://文件全路径
例子：
svn cat http://localhost/test/readme.txt
20、新建一个分支copy
svn copy branchA branchB -m "make B branch" // 从branchA拷贝出一个新分支branchB
21、合并内容到分支merge
svn merge branchA branchB // 把对branchA的修改合并到分支branchB