【山外笔记-框架工具】SVN版本控制系统
学习资料：
1、本文打印版下载地址：[山外笔记-框架工具笔记]SVN版本控制工具-打印版.pdf
2、SVN和TortoiseSVN在线中文文档：http://svndoc.iusesvn.com/
3、SVN教程-菜鸟教程：https://www.runoob.com/svn/svn-tutorial.html
4、SVN中文手册下载地址：svnbook1.4中文手册.pdf
5、TortoiseSVN中文文档下载地址：TortoiseSVN-1.9.3-zh_CN中文使用手册.pdf、TortoiseMerge-1.9.3-zh_CN.pdf
6、TortoiseSVN安装包：TortoiseSVN-1.13.1.28686-x64-svn-1.13.0.msi
7、TortoiseSVN语言包（中文）：LanguagePack_1.13.1.28686-x64-zh_CN.msi
本文重点内容：
1、SVN概述
2、SVN安装
3、SVN生命周期
4、SVN服务端操作
5、SVN客户端操作
6、TortoiseSVN 使用教程
一、SVN概述
1、SVN简介
（1）SVN是Apache Subversion的缩写，是一个开源的版本控制系统。
（2）SVN在2000年由CollabNet Inc开发，现已发展成为Apache软件基金会的一个项目。
（3）SVN管理着随时间改变的数据（比如代码），这些数据放置在一个中央资料档案库(repository)中，这个档案库会记住每一次文件的变动，可以把档案恢复到旧的版本, 或是浏览文件的变动历史。
（4）SVN管理源代码以行为单位，只要不是修改同一行代码，SVN都会自动合并两种修改。如果是同一行，SVN 会提示文件冲突（Conflict），需要手动确认。
（5）SVN相对于的RCS、CVS，采用了分支管理系统，设计目标就是取代CVS。
（6）SVN源代码地址：https://github.com/apache/subversion
2、SVN基本概念
（1）repository（源代码库）:源代码统一存放的地方。
（2）Checkout（提取）：从版本库创建一个工作副本到本地目录。
（3）Commit（提交）：提交本地已修改的代码到版本库（repository）中。
（4）Update (更新)：更新本地工作副本，和版本库同步。
3、SVN的主要功能
（1）目录版本控制
CVS只能跟踪单个文件的历史,但SVN能够依时间跟踪整个目录的变动，目录和文件都能进行版本控制。
（2）真实的版本历史
无论是文件还是目录，在SVN中可以增加（add）、删除（delete）、复制（copy）和重命名（rename），所有的新加的文件都从一个新的、干净的版本开始。
（3）自动提交
SVN允许一次提交，不管是单个还是多个文件都是作为一个整体提交的。允许开发人员以逻辑区间建立并提交变动，以防止当部分提交成功时出现的问题。
（4）纳入版本管控的元数据
每一个文件与目录都附有一组可以创建的属性关键字和属性值，即Key/Value。属性是随着时间来作版本管控的,就像文件內容一样。
（5）选择不同的网络层
- ① SVN有抽象的档案库存取概念, 可以很容易地实施新的网络机制。
- ② SVN可以作为一个扩展模块嵌入到Apache HTTP服务器中。
- ③ SVN还提供了许多重要功能: 如身份认证, 授权, 在线压缩, 以及文件库浏览等等。
- ④ SVN还有一个轻量级的独立SVN服务器，使用自定义的通信协议,可通过ssh以tunnel方式使用。
（6）一致的数据处理方式
SVN使用二进制差异算法来异表示文件的差异，将文件以压缩形式储存在档案库中,而且文件差异是以两个方向在网络上传输的。
（7）有效的分支(branch)与标签(tag)
SVN建立分支与标签的方法, 就只是复制该项目, 使用的方法就类似于硬连接（hard-link）。
（8）Hackability
SVN没有任何的历史包袱，主要是一群共用的C程序库,具有定义完善的API，便于维护。
4、SVN的优点：优于CVS之处
（1）原子提交：一次提交不管是单个还是多个文件，都是作为一个整体提交的。
（2）重命名、复制、删除文件等动作都保存在版本历史记录当中。
（3）对于二进制文件，使用了节省空间的保存方法。
（4）目录也有版本历史。整个目录树可以被移动或者复制，而且能够保留全部版本记录。
（5）分支的开销非常小。
（6）优化数据库访问，减少了不必要的数据库访问。
二、SVN安装
1、Windows下安装SVN
（1）下载地址：
（2）下载完成后，双击下载的安装文件进行安装，指定SVN的安装目录。
（3）添加环境变量：将SVN安装目录中的bin目录添加到path路径中。
（4）在CMD命令行窗口中输入svnserve -help命令验证是否安装成功。
2、CentOS下安装SVN
（1）大多数GNU/Linux发行版系统自带了SVN，使用svn --version命令检查是否安装。
（2）如果SVN客户端没有安装，将报告svn命令找不到的错误。
（3）如果SVN客户端已安装，将报告SVN的版本号和编译日期。
（4）安装命令：yum install -y subversion
3、Ubuntu下安装SVN
（1）大多数GNU/Linux发行版系统自带了SVN，使用svn --version命令检查是否安装。
（2）如果SVN客户端没有安装，将报告svn没有安装。
（3）如果SVN客户端已安装，将报告SVN的版本号和编译日期。
（4）安装命令：apt-get install subversion
三、SVN生命周期
1、创建版本库
（1）版本库相当于一个集中的空间，用于存放开发者所有的工作成果代码。
（2）版本库不仅能存放文件，还包括了每次修改的历史，即每个文件的变动历史。
（3）Create操作：用来创建一个新的版本库。
2、检出
（1）Checkout操作：用来从版本库创建一个工作副本。
（2）工作副本是开发者私人的工作空间，可以进行内容的修改，然后提交到版本库中。
3、更新
（1）update操作：用来更新版本库，将版本库同步到工作副本。
（2）版本库一直保持最新的代码，版本库一有更新，本地工作副本就会过期。
4、执行变更
（1）Rename操作：可以更改文件/目录的名字。
（2）移动操作：用来将文件/目录从一处移动到版本库中的另一处。
（3）添加操作：用来添加文件/目录，但这些添加的文件目录只是被添加进待变更列表中，直到执行了commit操作后才会成为版本库的一部分。
（4）删除操作：用来将文件从工作副本中删除掉，但该文件的实际删除只是被添加到了待变更列表中，直到执行了commit操作后版本库才会真正删除。
5、复查变化
（1）在commit操作之前复查下在工作副本中所进行的变动是一个很好的习惯。
（2）Status操作：列出工作副本中所进行的变动。
（3）Status操作只是提供了一个变动列表，但并不提供变动的详细信息。
（4）对工作副本的任何改动都会成为待变更列表的一部分，Status 操作就是用来查看这个待变更列表。
（5）diff操作：用来查看这些变动的详细信息。
6、修复错误
（1）Revert操作：重置对工作副本的修改，将会销毁待变更列表并将工作副本恢复到原始状态。
（2）Revert操作可以重置一个或多个文件/目录，也可以重置整个工作副本。
7、解决冲突
（1）Merge操作：自动处理可以安全合并的东西，其它的会被当做冲突。
（2）Resolve操作：用来帮助用户找出冲突并告诉版本库如何处理这些冲突。
8、提交更改
（1）Commit操作：用来将更改从工作副本到版本库。
（2）Commit操作会修改版本库的内容，其它开发者可以通过更新他们的工作副本来查看这些修改。
（3）Commit是一个原子操作，要么完全提交成功，要么失败回滚，用户不会看到成功提交一半的情况。
（4）在提交之前，必须将文件/目录添加到待变更列表中。列表中记录了将会被提交的改动。
（5）当提交的时候，通常会提供一个注释来说明改动。这个注释也会成为版本库历史记录的一部分。
四、SVN服务端操作
1、配置SVN启动模式
（1）新建版本库目录：mkdir /opt/svn
（2）创建版本库：svnadmin create /opt/svn/svntest
（3）启动版本库：svnserve -d -r 目录--listen-port 端口号
- ① -r：配置方式决定了版本库访问方式。
- ② --listen-port：指定SVN监听端口，不加此参数，SVN默认监听3690
（4）单库svnserve方式：-r直接指定到版本库
-
① 命令：
svnserve -d -r /opt/svn/svntest -
② 一个svnserve只能为一个版本库工作。
-
③ authz配置文件中对版本库权限的配置：
[groups] admin=user1 dev=user2 [/]@admin=rw user2=r -
④ URL：输入svn://192.168.0.1/，即可访问svntest版本库
（5）多库svnserve方式：-r指定到版本库的上级目录
-
① 命令：
svnserve -d -r /opt/svn -
② 一个svnserve可以为多个版本库工作。
-
③ authz配置文件中对版本库权限的配置：
[groups] admin=user1 dev=user2 [svntest:/]@admin=rw user2=r [svntest01:/]@admin=rw user2=r -
④ 用[/]，则表示所有库的根目录，即[/src]表示所有库的根目录下的src目录。
-
⑤ URL：svn://192.168.0.1/svntest，即可访问svntest版本库。
2、创建SVN版本库
（1）新建版本库目录：mkdir /opt/svn
（2）创建版本库：svnadmin create /opt/svn/svntest
（3）以多库svnserve方式启动SVN：svnserve -d -r /opt/svn，URL：svn://192.168.0.1/svntest01
（4）配置目录：/opt/svn/svntest/conf，包括svnserve.conf、passwd、authz配置文件。
（5）SVN服务配置文件：svnserve.conf
[general]
anon-access = none
auth-access = write
password-db = /home/svn/passwd
authz-db = /home/svn/authz
realm = tiku
-
① anon-access：控制非鉴权用户访问版本库的权限，取值范围为write、read和none。即write为可读可写，read为只读，none表示无访问权限。默认值：read
-
② auth-access：控制鉴权用户访问版本库的权限。默认值：write
-
③ password-db：指定用户名口令文件，默认为conf目录中的passwd。
-
④ authz-db：指定权限配置文件，实现以路径为基础的访问控制。默认值：authz
-
⑤ realm：指定版本库的认证域，即在登录时提示的认证域名称。
- ❶ 若两个版本库的认证域相同，建议使用相同的用户名口令数据文件。
- ❷ 默认值： UUID(Universal Unique IDentifier，全局唯一标示)。
（6）用户名口令文件passwd
-
① 用户名口令文件由svnserve.conf的配置项password-db指定，默认为conf目录中的passwd。
-
② passwd文件仅由一个[users]配置段组成。
-
③ [users]配置段配置行格式：<用户名> = <口令>
[users] admin = admin thinker = 123456
（7）权限配置文件authz
-
① 权限配置文件由svnserve.conf的配置项authz-db指定，默认为conf目录中的authz。
-
② authz配置文件由一个[groups]配置段和若干个版本库路径权限段组成。
-
③ [groups]配置段中配置行格式如下：<用户组> = <用户列表>
-
④ 版本库路径权限段的段名格式如下：[<版本库名>:<路径>]
[groups] g_admin = admin,thinker [admintools:/] @g_admin = rw * = [test:/home/thinker] thinker = rw * = r
五、SVN客户端操作
1、SVN检出操作
（1）创建版本库svntest,URL为svn://192.168.0.1/svntest,svn用户user01有读写权限。
（2）检出命令：svn checkout svn://192.168.0.1/svntest --username=user01
（3）查看检出工作副本信息命令：svn info .
2、SVN提交操作
（1）在工作副本中新建一个文件：echo “Hello，SVN” > HelloSVN.txt
（2）查看工作副本状态：svn status，状态显示为？，说明还未加到版本控制中。
（3）添加到版本控制中：svn add HelloSVN.txt
（4）查看工作副本状态：svn status，状态显示为A，说明已添加到版本控制中。
（5）提交到版本库：svn commit -m "SVN readme."
- ① -m：备注本次提交的注释信息，如果忽略了，SVN会打开一个文本编辑器来让你输入提交信息。
- ② 命令执行后会输出提交的文件，并且修订版本号自动增加了1。
3、SVN解决冲突
（1）冲突的原因：SVN管理源代码以行为单位，只要不是修改同一行代码，SVN都会自动合并两种修改。如果是同一行，SVN 会提示文件冲突（Conflict），需要手动确认。
（2）解决过程：假设版本库版本号为10时，用户A和用户B同时对修改了svntest.txt文件中的同一行。
- ① 用户A先提交了自己修改的文件到版本库，提交成功后，版本库版本号变更为11.
- ② 用户B提交自己修改的文件到版本库时，提交失败，产生冲突。
- ③ 用户A提交后版本号已经变更，用户B的工作副本已经失效，SVN不会允许用户B提交修改操作。
- ④ 用户B先查看用户A提交的修改和自己的修改的差异，执行
svn diff命令。 - ⑤ 用户B需要更新工作副本，执行
svn update命令，可以指定更新到的版本，默认是最新的版本。 - ⑥ 工作副本和版本库同步后，用户B可以提交自己的修改到版本库。
4、SVN版本回退
（1）svn revert操作：撤销任何文件或目录里的局部更改，即对文件的修改。
（2）撤销文件修改的具体操作流程：
-
① 查看SVN状态：执行
svn status命令，显示文件名及其状态，状态为M，说明文件被修改。 -
② 撤销文件的修改：执行
svn revert filename -
③ 再次查看SVN状态：执行
svn status命令，没有任何显示，说明撤销成功。
（3）撤销目录修改操作同撤销文件修改，只是恢复目录用需要使用-R选项，即svn revert -R dirname。
（4）恢复一个已经提交的版本
-
① 消除旧版本，必须撤销旧版本里的所有更改然后提交一个新版本，这种操作叫做reverse merge。
-
② 命令：
svn merge -r 22:21 filename，当前版本22，上一个版本21。
5、SVN查看历史信息
通过svn命令可以根据时间或修订号去除过去的版本，或者某一版本所做的具体的修改。
（1）svn log：用来展示svn 的版本作者、日期、路径等等。
- ① 只查看特定的某两个版本之间的信息：
svn log -r 6:8 - ② 只查看某一个文件的版本修改信息：
svn log file_path/filename - ③ 只查看目录的版本修改信息：
svn log -v file_path
④ 显示限定N条记录的目录信息：svn log -l N -v
（2）svn diff：用来显示特定修改的行级详细信息。
- ① 比较工作副本接本地版本库的修改：
svn diff - ② 比较工作副本与版本库的修改：
svn diff -r 3 filename - ③ 比较版本库与版本库的修改：
svn diff -r 2:3 filename，版本号之间用冒号分隔。
（3）svn cat：查看在特定版本中的某文件的内容，执行svn cat -r 版本号 filename。
（4）svn list：显示一个目录或某一版本存在的文件，执行svn list -r 版本号 dir_path。
6、SVN分支
Branch分支就是trunk版（主干线）的一个copy版，也具有版本控制功能，而且和主干线相互独立，最后可以通过合并功能，将分支合并到trunk上来，合并为一个项目。
（1）在本地工作副本创建一个分支：svn copy trunk/ branch/mybranch
（2）查看SVN状态：svn status
（3）提交新增的分支到版本库：svn commit -m "add my_branch"
（4）合并my_branch分支到trunk中：svn merge . ./branches/my_branch/
7、SVN标签（tag）
SVN支持tag选项，可以给某一个具体版本的代码一个标签，主要用于项目开发中的里程碑,往往代表一个可以固定的完整的版本。
（1）在本地工作副本创建一个tag分支：svn copy trunk/ tags/v1.0
（2）查看SVN状态：svn status
（3）提交tag内容： svn commit -m "tags v1.0"
六、TortoiseSVN使用教程
1、TortoiseSVN简介
TortoiseSVN是Subversion版本控制系统的一个免费开源GUI客户端
2、安装TortoiseSVN
（1）下载地址：https://tortoisesvn.net/downloads.html, 页面里有语言包补丁的下载链接。
（2）运行下载的 TortoiseSVN 安装程序
（3）运行下载的 TortoiseSVN 中文语言包
（4）重启电脑，确认TortoiseSVN安装完成。
（5）修改TortoiseSVN默认语言
- ① TortoiseSVN默认语言英文，可以通过设置修改成已安装语言。
- ② 鼠标在桌面空白处右击—>TortoiseSVN—>设置。
3、TortoiseSVN创建服务端版本库
（1）在本地新建一个目录,进入新建的目录.
（2）创建版本库：鼠标在空白右击—>TortoiseSVN—>在此创建版本库
（3）版本库创建完成后，目录中会出现Server端的文件，和svnserve命令创建的一致。
4、TortoiseSVN创建工作副本
（1）在本地创建工作目录,进入创建的目录.
（2）SVN检出:鼠标在空白右击，选择 SVN检出（checkout），弹出检出会话框。
- ① 版本库URL：repository(版本库)的位置URL，即svn://192.168.0.1/svntest
- ② 检出至目录：本地创建的工作目录路径。
- ③ 检出深度和版本默认（最新版）即可，点击确定。
- ④ 检出完成后，可以看到工作目录里多了一个
.svn的隐藏目录。
5、TortoiseSVN客户端操作
（1）svn update操作：鼠标在工作副本空白处右击—>SVN 更新（U）
（2）svn add操作：鼠标在工作副本空白处右击—> TortoiseSVN—>增加（A）
（3）svn commit操作：鼠标在工作副本空白处右击—>SVN 提交（C）
（4）svn copy操作：鼠标在工作副本空白处右击—> TortoiseSVN—>分支/标签（T）
（5）svn merge操作：鼠标在工作副本空白处右击—> TortoiseSVN—>合并（M）
（6）svn import操作：鼠标在工作副本空白处右击—> TortoiseSVN—>导入（I）
（7）svn export操作：鼠标在工作副本空白处右击—> TortoiseSVN—>导出（X）
（8）svn lock操作：鼠标在工作副本空白处右击—> TortoiseSVN—>获取锁定（K）
（9）svn unlock操作：鼠标在工作副本空白处右击—> TortoiseSVN—>解除锁定（K）
（10）svn cleanup操作：鼠标在工作副本空白处右击—> TortoiseSVN—>清理（C）
免责声明：本文整理自《SVN中文手册》、《TortoiseSVN中文手册》、《菜鸟教程-SVN教程》和个人的学习总结，属于个人的学习笔记，仅用于学习和分享交流，不涉及商业用途。文中涉及的下载资源均来源于网络，版权归原作者所有，请在下载后24小时之内自觉删除，若作商业用途，请购买正版，由于未及时购买和付费发生的侵权行为，与本文无关。如果本文发布的内容侵犯到相关的权益，请及时联系本人进行删除！