【山外笔记-工具框架】SVN版本控制系统

2024-02-15 14:18:52

【山外笔记-框架工具】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小时之内自觉删除，若作商业用途，请购买正版，由于未及时购买和付费发生的侵权行为，与本文无关。如果本文发布的内容侵犯到相关的权益，请及时联系本人进行删除！

码农公寓