SVN版本控制工具的使用

2020-05-26 本文已影响0人 CurryCoder

技术交流QQ群:1027579432，欢迎你的加入！

欢迎关注我的微信公众号：CurryCoder的程序人生

1.SVN中的基础概念

repository:源代码库，源代码统一存放的地方
checkout:当手上没有源代码时，可以从源代码库中checkout一份
commit:当你已经修改了代码，就需要commit到源代码仓库
update:当你已经checkout了一份源代码后，update一下就可以和源代码仓库上的源代码同步，手上的代码就会有最新的变更。
日常使用流程：假设你已经在几天前checkout，update获取最新的代码->自己进行修改并调试成功源代码->commit(大家就可以看到你的修改)
如果两个程序员同时修改了同一个文件, SVN可以合并这两个程序员的改动，实际上SVN管理源代码是以行为单位的，即两个程序员只要不是修改同一行程序，SVN都会自动合并两种修改。如果是同一行，SVN 会提示文件 Conflict, 冲突，需要手动确认。

2.linux系统下安装SVN

yum install subversion(Centos下安装)
sudo apt-get install subversion(Ubuntu下安装)

查看SVN的版本：subversion --version

cdl@cdl-Inspiron-5421:~$ svn --version
svn，版本 1.9.3 (r1718519)
编译于 Jul 26 2019，15:51:17 在 x86_64-pc-linux-gnu

3.SVN启动模式

在服务端进行SVN版本库的相关配置，手动创建版本库目录：
```
cdl@cdl-Inspiron-5421:~$ sudo mkdir /opt/svn
[sudo] cdl 的密码： 
```
利用SVN命令创建版本库：
```
svnadmin create /opt/svn/CurryCoder
```
使用命令svnserve启动服务：
- -r：决定了版本库的访问方式；
- --listen-port：指定svn监听端口，不加此参数，默认为3690
```
svnserve -d -r 目录 --listen-port 端口号
```
- 单库svnserve方式：一个svnserve只能为一个版本库工作；
```
svnserve -d -r /opt/svn/CurryCoder
```
  - authz配置文件中对版本库权限的配置为：
```
[groups]
admin=user1
dev=user2
[/]
@admin=rw
user2=r
```
  - 使用类似这样的URL：svn://192.168.0.1/　即可访问CurryCoder版本库
- 多库svnserve方式：指定到版本的上级目录，一个svnserve可以为多个版本库工作。
```
svnserve -d -r /opt/svn
```
  - authz配置文件中对版本库的配置：
```
[groups]
admin=user1
dev=user2
[CurryCoder:/]
@admin=rw
user2=r

[CurryCoder01:/]
@admin=rw
user2=r
```
  - 使用类似这样的URL：svn://192.168.0.1/CurryCoder　即可访问CurryCoder版本库

3.创建版本库

使用svnadmin create 目录进行创建版本库。

cdl@cdl-Inspiron-5421:~$ sudo svnadmin create /opt/svn/CurryCoder01
[sudo] cdl 的密码： 
cdl@cdl-Inspiron-5421:~$ ll /opt/svn/CurryCoder01/
总用量 32
drwxr-xr-x 6 root root 4096 5月  26 11:19 ./
drwxr-xr-x 4 root root 4096 5月  26 11:19 ../
drwxr-xr-x 2 root root 4096 5月  26 11:19 conf/
drwxr-sr-x 6 root root 4096 5月  26 11:19 db/
-r--r--r-- 1 root root    2 5月  26 11:19 format
drwxr-xr-x 2 root root 4096 5月  26 11:19 hooks/
drwxr-xr-x 2 root root 4096 5月  26 11:19 locks/
-rw-r--r-- 1 root root  246 5月  26 11:19 README.txt

进入/opt/svn/CurryCoder01/conf目录，修改默认配置文件内容，包括svnserve.conf、passwd、authz等信息。

svn服务配置文件为版本库目录中的文件conf/svnserve.conf，该文件仅由一个[general]配置字段组成：

[general]
anon-access = none     # 控制非授权用户访问版本库的权限
auth-access = write    # 控制授权用户访问版本库的权限。
password-db = /home/svn/passwd
authz-db = /home/svn/authz  # 指定权限配置文件名，通过该文件可以实现以路径为基础的访问控制。除非指定绝对路径，否则文件位置为相对conf目录的相对路径。 默认值：authz
realm = tiku  # 指定版本库的认证域，即在登录时提示的认证域名称。

用户名口令文件passwd：用户名口令文件由svnserve.conf的配置项password-db指定，默认为conf目录中的passwd。该文件仅由一个[users]配置段组成:
```
[users]  
admin = admin  # <用户名> = <口令>
CurryCoder = 123456
```
权限配置文件：权限配置文件由svnserve.conf的配置项authz-db指定，默认为conf目录中的authz。该配置文件由一个[groups]配置段和若干个版本库路径权限段组成：
```
[groups]   # <用户组> = <用户列表>
g_admin = admin,CurryCoder

[admintools:/]  # [<版本库名>:<路径>] 
@g_admin = rw
* =

[test:/home/CurryCoder]
CurryCoder = rw
* = r
```

4.checkout(克隆副本)操作

通过url svn://192.168.0.1(具体的svn服务器地址)/CurryCoder01 --username=user01，如下所示：

cdl@cdl-Inspiron-5421:~$ svn checkout svn://192.168.0.1/CurryCoder01 --username=user01
A    CurryCoder01/trunk
A    CurryCoder01/branches
A    CurryCoder01/tags
Checked out revision 1.

checkout成功后在当前目录下生成CurryCoder01副本目录，如下所示：

root@cdl-Inspiron-5421:/home/cdl#  ll CurryCoder01/
total 24
drwxr-xr-x 6 root root 4096 Jul 21 19:19 ./
drwxr-xr-x 3 root root 4096 Jul 21 19:10 ../
drwxr-xr-x 2 root root 4096 Jul 21 19:19 branches/
drwxr-xr-x 4 root root 4096 Jul 21 19:19 .svn/
drwxr-xr-x 2 root root 4096 Jul 21 19:19 tags/
drwxr-xr-x 2 root root 4096 Jul 21 19:19 trunk/

5.解决版本冲突

版本冲突的产生原因：假设A和B两个程序员都在版本号为100时，修改了HelloWorld.html文件。程序员A在修改完成后提交HelloWorld.html文件到服务器。此时，提交成功后HelloWorld.html文件的版本号变为101。同时，B程序员在版本号为100的HelloWorld.html文件上修改。修改完成后，提交到服务器时，由于不是在当前最新的101版本上修改的，所以提交时会失败。

查看修改后的文件内容：

root@cdl-Inspiron-5421:~/svn/CurryCoder01/trunk$# cat HelloWorld.html 
HelloWorld! http://www.runoob.com/

查看更改：

root@cdl-Inspiron-5421:~/svn/CurryCoder01/trunk$# svn diff
Index: HelloWorld.html
===================================================================
--- HelloWorld.html     (revision 5)
+++ HelloWorld.html     (working copy)
@@ -1,2 +1 @@
-HelloWorld! http://www.runoob.com/
+HelloWorld! http://www.runoob.com/!

user01提交会出现失败：

root@cdl-Inspiron-5421:~/svn/CurryCoder01/trunk$# svn commit -m "change HelloWorld.html first"
Sending        HelloWorld.html
Transmitting file data .svn: E160028: Commit failed (details follow):
svn: E160028: File '/trunk/HelloWorld.html' is out of date

提交失败的原因：HelloWorld.html已经被user02修改并提交到了仓库。svn不会允许user01提交更改，因为user02已经修改了仓库，所以user01的工作副本已经失效。为了避免两人的代码被互相覆盖，svn不允许进行这样的操作。所以user01在提交更改之前必须先更新工作副本。所以使用update命令，如下:

root@cdl-Inspiron-5421:~/svn/CurryCoder01/trunk$# svn update
Updating '.':
C    HelloWorld.html
Updated to revision 6.
Conflict discovered in file 'HelloWorld.html'.
Select: (p) postpone, (df) show diff, (e) edit file, (m) merge,
        (mc) my side of conflict, (tc) their side of conflict,  # 输入mc表示以本地文件为主，也可以使用其他选项对冲突文件进行不同的操作。
        (s) show all options: mc
Resolved conflicted state of 'HelloWorld.html'
Summary of conflicts:
Text conflicts: 0 remaining (and 1 already resolved)

默认是更新到最新的版本，也可以指定更新到哪个版本：
```
svn update -r6
```

工作副本已经与仓库同步，可以进行提交：

root@cdl-Inspiron-5421:~/svn/CurryCoder01/trunk$# svn commit -m "change HelloWorld.html second"

6.SVN提交操作

在版本库中增加一个readme的说明文件：

root@cdl-Inspiron-5421:~/svn/CurryCoder01/trunk$# cat readme
this is SVN tutorial.

查看工作副本的状态：

root@cdl-Inspiron-5421:~/svn/CurryCoder01/trunk$# svn status
?       readme  # ？说明它还未加到版本控制中

将文件readme加到版本控制，等待提交到版本库。

root@cdl-Inspiron-5421:~/svn/CurryCoder01/trunk$# svn add readme
A         readme

查看工作副本的状态：

root@cdl-Inspiron-5421:~/svn/CurryCoder01/trunk$# svn status
A       readme  # A意味着这个文件已经被成功地添加到了版本控制中

为了把readme存储到版本库中，使用commit -m加上注释信息来提交:

root@cdl-Inspiron-5421:~/svn/CurryCoder01/trunk$# svn commit -m "SVN readme."
Adding         readme
Transmitting file data .
Committed revision 8.
svn commit -m "SVN readme."

7.SVN版本回退

当我们想放弃对文件的修改，可以使用 SVN revert 命令。svn revert操作将撤销任何文件或目录里的局部更改。

对文件readme文件进行修改(readme文件还没有被提交)，查看文件状态：

root@cdl-Inspiron-5421:~/svn/CurryCoder01/trunk$# svn status
M         readme   # M表示readme文件已经被修改

但是，发现修改readme文件出现错误，要撤销修改，通过svn revert命令将文件readme回退到未修改状态：
```
root@cdl-Inspiron-5421:~/svn/CurryCoder01/trunk$# svn revert readme
Reverted 'readme'
```
revert操作不单单可以使单个文件恢复原状，而且可以使整个目录恢复原状。恢复目录用-R命令：
```
svn revert -R trunk
```
如何恢复一个已经提交的版本？为了消除一个旧版本，必须撤销旧版本里的所有更改然后提交一个新版本。首先，找到仓库的当前版本，假设现在是版本22，我们要撤销回之前的版本，比如版本21。
```
svn merge -r 22:21 readme
```

8.SVN查看历史信息

svn log: 显示svn的版本作者、日期、路径等信息；
- 如果只希望查看特定的某两个版本之间的信息，可以使用：svn log -r 6:8
- 如果只想查看某个文件的版本修改信息，可以使用：svn log 文件路径
- 如果希望得到目录的信息要加 -v
  如果希望显示限定N条记录的目录信息：svn log -l N -v
svn diff: 显示特定修改的行的详细信息；
- 如果用svn diff，不带任何参数，它将会比较你的工作文件与缓存在.svn的"原始"拷贝
- 比较你工作拷贝和版本库中版本号为3的文件rule.txt: svn diff -r rule.txt
- 比较 svn 工作版本中版本号2和3的这个文件的变化：svn diff -r 2:3 rule.txt
svn cat：将特定版本的某个文件内容显示在屏幕上；
- 如果只是希望检查一个过去版本，不希望查看它们的区别: svn cat -r 版本号 rule.txt
svn list：可以在不下载文件到本地目录的情况下来察看目录中的文件；
- svn list http://192.168.0.1/CurryCoder01

9.SVN分支

应用场景：当有人希望开发过程分开成两条不同的路线时，此时使用分支。比如项目下有两个小组，svn下有一个trunk版本。由于客户需求突然变化，导致项目需要做较大改动，此时项目组决定由小组1继续完成原来正进行到一半的工作（某个模块），小组2进行新需求的开发。那么此时，我们就可以为小组2建立一个分支，分支其实就是trunk版（主干线）的一个copy版，不过分支也是具有版本控制功能的，而且是和主干线相互独立的，当然，最后我们可以通过（合并）功能，将分支合并到trunk上来，从而最后合并为一个项目。

本地副本中创建my_branch分支：

root@cdl-Inspiron-5421:~/svn/CurryCoder01# svn copy branches/my_branch

查看状态：

root@cdl-Inspiron-5421:~/svn/CurryCoder01# svn status
A  +    branches/my_branch
A  +    branches/my_branch/HelloWorld.html
A  +    branches/my_branch/readme

提交新增的分支到版本库中：

root@cdl-Inspiron-5421:~/svn/CurryCoder01# svn commit -m "add my_branch"
Adding         branches/my_branch
Replacing      branches/my_branch/HelloWorld.html
Adding         branches/my_branch/readme

Committed revision 9.

切换到分支路径并创建index.html文件：

root@cdl-Inspiron-5421:~/svn/CurryCoder01# cd branches/my_branch/
root@cdl-Inspiron-5421:~/svn/CurryCoder01/branches/my_branch# ls
HelloWorld.html  index.html  readme

将index.html加入版本控制，并提交到版本库中:

root@cdl-Inspiron-5421:~/svn/CurryCoder01/branches/my_branch# svn status
?       index.html

root@cdl-Inspiron-5421:~/svn/CurryCoder01/branches/my_branch# svn add index.html
A         index.html

root@cdl-Inspiron-5421:~/svn/CurryCoder01/branches/my_branch# svn commit -m "add index.html"
Adding         index.html
Transmitting file data .
Committed revision 10.

切换到trunk主分支，执行svn update，然后将my_branch分支合并到trunk主分支中：

root@cdl-Inspiron-5421:~/svn/CurryCoder01/trunk# svn merge ../branches/my_branch/
--- Merging r10 into '.':
A    index.html
--- Recording mergeinfo for merge of r10 into '.':
G   .

将合并好的trunk主分支提交到版本库中：

root@cdl-Inspiron-5421:~/svn/CurryCoder01/trunk# svn commit -m "add index.html"
Adding         index.html
Transmitting file data .
Committed revision 11.

10.SVN标签

版本管理系统支持tag选项，通过使用tag的概念，可以给某一个具体版本的代码一个更加有意义的名字。

在本地工作副本创建一个tag:

root@cdl-Inspiron-5421:~/svn/CurryCoder01# svn copy trunk/ tags/v1.0
A         tags/v1.0

上面的代码成功完成，新的目录将会被创建在tags目录下:

root@cdl-Inspiron-5421:~/svn/CurryCoder01# ls tags/
v1.0
root@cdl-Inspiron-5421:~/svn/CurryCoder01# ls tags/v1.0/
HelloWorld.html  readme

查看状态：

root@cdl-Inspiron-5421:~/svn/CurryCoder01# svn status
A  +    tags/v1.0

提交tag内容：

root@cdl-Inspiron-5421:~/svn/CurryCoder01# svn commit -m "tags v1.0"
Adding         tags/v1.0
Transmitting file data ..
Committed revision 14.