常用 SVN 命令简介及使用

博客作者：联系请点击，搬运不易，希望请作者喝咖啡，可以点击联系博客作者

前言

SVN（Subversion）是一个自由、开源的项目源代码版本控制工具。目前，绝大多数开源软件和企业代码管理，都使用SVN作为代码版本管理软件。

Subversion将文件存放在中心版本库里，这个版本库很像一个普通的文件服务器。不同的是，它可以记录每一次文件和目录的修改情况，这样就可以在需要回滚时，将数据恢复到以前的版本，并可以查看数据的更改细节。

SVN 官方网址：

Apache Subversion

一、SVN 服务器安装及配置：

1. 添加SVN高版本YUM源

vim /etc/yum.repos.d/wandisco-svn.repo

CentOS/RHEL 7：

[WandiscoSVN]
name=Wandisco SVN Repo
baseurl=http://opensource.wandisco.com/centos/7/svn-1.9/RPMS/$basearch/
enabled=1
gpgcheck=0

CentOS/RHEL 6：

[WandiscoSVN]
name=Wandisco SVN Repo
baseurl=http://opensource.wandisco.com/centos/6/svn-1.9/RPMS/$basearch/
enabled=1
gpgcheck=0

CentOS/RHEL 5：

[WandiscoSVN]
name=Wandisco SVN Repo
baseurl=http://opensource.wandisco.com/centos/5/svn-1.9/RPMS/$basearch/
enabled=1
gpgcheck=0

2. 安装第三方Yum源及清除Yum源缓存

yum install -y epel-release yum-utils 
yum clean all
yum makecache

3. 安装最新版Subversion

yum install -y subversion

4. 查看安装的Subversion版本

[root@svn ~]# svn --version
svn，版本 1.9.12 (r1863368)
   编译于 Aug 14 2019，16:35:53 在 x86_64-redhat-linux-gnu

Copyright (C) 2019 The Apache Software Foundation.
This software consists of contributions made by many people;
see the NOTICE file for more information.
Subversion is open source software, see http://subversion.apache.org/

可使用以下的版本库访问模块:

* ra_svn : 使用 svn 网络协议访问版本库的模块。  - 使用 Cyrus SASL 认证
  - 处理“svn”方案
* ra_local : 访问本地磁盘的版本库模块。
  - 处理“file”方案
* ra_serf : Module for accessing a repository via WebDAV protocol using serf.
  - using serf 1.3.9 (compiled with 1.3.9)
  - 处理“http”方案
  - 处理“https”方案

The following authentication credential caches are available:

* Plaintext cache in /root/.subversion
* Gnome Keyring
* GPG-Agent

注意：如果是CentOS/RHEL 8则需要手动下载最新版相关rpm包

访问下面地址 ：

http://opensource.wandisco.com/centos/7/svn-1.9/RPMS/x86_64/

下载如下安装包：

wget http://opensource.wandisco.com/centos/7/svn-1.9/RPMS/x86_64/libserf-1.3.9-1.el7.x86_64.rpm
wget http://opensource.wandisco.com/centos/7/svn-1.9/RPMS/x86_64/libserf-debuginfo-1.3.9-1.el7.x86_64.rpm
wget http://opensource.wandisco.com/centos/7/svn-1.9/RPMS/x86_64/libserf-devel-1.3.9-1.el7.x86_64.rpm
wget http://opensource.wandisco.com/centos/7/svn-1.9/RPMS/x86_64/mod_dav_svn-1.9.9-1.x86_64.rpm
wget http://opensource.wandisco.com/centos/7/svn-1.9/RPMS/x86_64/subversion-1.9.9-1.x86_64.rpm
wget http://opensource.wandisco.com/centos/7/svn-1.9/RPMS/x86_64/subversion-devel-1.9.9-1.x86_64.rpm
wget http://opensource.wandisco.com/centos/7/svn-1.9/RPMS/x86_64/subversion-gnome-1.9.9-1.x86_64.rpm
wget http://opensource.wandisco.com/centos/7/svn-1.9/RPMS/x86_64/subversion-perl-1.9.9-1.x86_64.rpm
wget http://opensource.wandisco.com/centos/7/svn-1.9/RPMS/x86_64/subversion-python-1.9.9-1.x86_64.rpm
wget http://opensource.wandisco.com/centos/7/svn-1.9/RPMS/x86_64/subversion-tools-1.9.9-1.x86_64.rpm

CentOS/RHEL 8安装

注意：需要在当前下载rpm包的目录下执行

yum -y install --skip-broken *.rpm
rm -rf *.rpm                   #安装完需要把下载的rpm包删除

CentOS/RHEL 8查看安装版本是否安装成功的

[root@SVN ~]# svn --version
svn，版本 1.9.9 (r1835931)
   编译于 Jul 25 2018，12:41:27 在 x86_64-redhat-linux-gnu

Copyright (C) 2018 The Apache Software Foundation.
This software consists of contributions made by many people;
see the NOTICE file for more information.
Subversion is open source software, see http://subversion.apache.org/

可使用以下的版本库访问模块:

* ra_svn : 使用 svn 网络协议访问版本库的模块。  - 使用 Cyrus SASL 认证
  - 处理“svn”方案
* ra_local : 访问本地磁盘的版本库模块。
  - 处理“file”方案
* ra_serf : Module for accessing a repository via WebDAV protocol using serf.
  - using serf 1.3.9 (compiled with 1.3.8)
  - 处理“http”方案
  - 处理“https”方案

The following authentication credential caches are available:

* Plaintext cache in /root/.subversion
* Gnome Keyring
* GPG-Agent

[root@SVN ~]# cat /etc/redhat-release
CentOS Linux release 8.0.1905 (Core)
[root@SVN ~]# uname -r
4.18.0-80.el8.x86_64

二、创建svn资源库目录及配置

1. 创建svn资源库目录及初始化项目

mkdir -p /var/svn/project
svnadmin create /var/svn/project

初始化项目完成后会看到如下文件

[root@svn ~]# ll /var/svn/project
总用量 8
drwxr-xr-x. 2 root root  76 1月   4 19:47 conf
drwxr-sr-x. 6 root root 233 1月   4 19:47 db
-r--r--r--. 1 root root   2 1月   4 19:47 format
drwxr-xr-x. 2 root root 231 1月   4 19:47 hooks
drwxr-xr-x. 2 root root  41 1月   4 19:47 locks
-rw-r--r--. 1 root root 246 1月   4 19:47 README.txt

2. 配置

进入conf文件夹，这个是存放配置文件的

[root@svn conf]# pwd
/var/svn/project/conf
[root@svn conf]# ls
authz  hooks-env.tmpl  passwd  svnserve.conf

其中：

hooks-env.tmpl #该文件是示例钩子脚本环境配置文件 authz #该文件是权限控制文件 passwd #该文件是帐号密码文件 svnserve.conf #该文件是SVN服务配置文件

配置 svnserv.conf

注：采用默认配置，以下语句都必须顶格写，左侧不能留空格，否则会出错。

vim svnserv.conf
[general]
anon-access = none       # 使非授权用户无法访问
auth-access = write      # 使授权用户有写权限
password-db = passwd     # 用户密码文件
authz-db = authz         # 访问控制文件
realm = /var/svn/project # 认证命名空间，subversion会在认证提示里显示，并且作为凭证缓存的关键字。

配置passwd （格式：帐号=密码)

[root@svn conf]# vim passwd
test1 = 123456
test2 = 123456

配置authz (格式：帐号 = 权限)

[/]
username = rw 
# r：读，w：写
注：还有更加细致的权限配置，在这里就不在写了，大家可以查看SVN文档。

3. 启动与停止SVN服务

启动

svnserve -d -r [dir]
例如：svnserve -d -r /var/svn

停止

killall svnserve

注：默认的端口是3690，在检出提交操作之前请检测此端口是否允许出站入站。如不允许，请设置好防火墙或安全组。

4. 客户端访问

客户端访问格式：svn://IP/project

比如:我创建的项目目录是project，访问就是如下图。

注意：如果授权的账号只有子目录权限则需要输入主项目下的子目录路径才可以认证成功

5. Windows客户端下载地址

下载 · TortoiseSVN

需要根据安装的Windows系统版本下载相对应软件安装包和语言汉化包。

注意：下载中文汉化包需要与下载的SVN客户端相对应版本，安装好汉化包需要重启电脑才能生效。

三、 SVN常用命令

1. 将文件checkout到本地目录

svn checkout path           #path是服务器上的目录
例如：svn checkout svn://192.168.1.1/pro/domain
简写：svn co

2、往版本库中添加新的文件

svn add file
例如：svn add test.php     #添加test.php
     svn add *.php        #添加当前目录下所有的php文件

3、将改动的文件提交到版本库

svn commit -m "LogMessage" [-N] [--no-unlock] PATH  #如果选择了保持锁，就使用--no-unlock开关
例如：svn commit -m "add test file for my test" test.php
简写：svn ci

4、加锁/解锁

svn lock -m "LockMessage" [--force] PATH
例如：svn lock -m "lock test file" test.php
     svn unlock PATH

5、更新到某个版本

svn update -r m path
例如：
svn update                   #如果后面没有目录，默认将当前目录以及子目录下的所有文件都更新到最新版本。
svn update -r 200 test.php   #将版本库中的文件test.php还原到版本200
svn update test.php          #更新，于版本库同步。如果在提交的时候提示过期的话，是因为冲突，需要先update，修改文件，然后清除svn resolved，最后再提交commit
简写：svn up

6、查看文件或者目录状态

1）svn status path       #目录下的文件和子目录的状态，正常状态不显示
 ?：不在svn的控制中；M：内容被修改；C：发生冲突；A：预定加入到版本库；K：被锁定
  
2）svn status -v path    #显示文件和子目录状态
  第一列保持相同，第二列显示工作版本号，第三和第四列显示最后一次修改的版本号和修改人。
  
  注：svn status、svn diff和 svn revert这三条命令在没有网络的情况下也可以执行的，原因是svn在本地的.svn中保留了本地版本的原始拷贝。
简写：svn st

7、删除文件

svn delete path -m "delete test fle"
例如：svn delete svn://192.168.1.1/pro/domain/test.php -m "delete test file"
或者直接svn delete test.php 然后再svn ci -m 'delete test file'，推荐使用这种
简写：svn (del, remove, rm)

8、查看日志

svn log path
例如：svn log test.php   #显示这个文件的所有修改记录，及其版本号的变化

9、查看文件详细信息

svn info path
例如：svn info test.php

10、比较差异

svn diff path          #将修改的文件与基础版本比较
例如：svn diff test.php
svn diff -r m:n path   #对版本m和版本n比较差异
例如：svn diff -r 200:201 test.php
简写：svn di

11、将两个版本之间的差异合并到当前文件

svn merge -r m:n path
例如：svn merge -r 200:205 test.php  #将版本200与205之间的差异合并到当前文件，但是一般都会产生冲突，需要处理一下

12、SVN 帮助

svn help
svn help ci

以上是常用命令，下面写几个不经常用的

13、版本库下的文件和目录列表

svn list path              #显示path目录下的所有属于版本库的文件和目录
简写：svn ls

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

svn mkdir:                 #创建纳入版本控制下的新目录。
用法:     
1、mkdir PATH...
2、mkdir URL...
创建版本控制的目录。
1、每一个以工作副本 PATH 指定的目录，都会创建在本地端，并且加入新增调度，以待下一次的提交。
2、每个以URL指定的目录，都会透过立即提交于仓库中创建。
在这两个情况下，所有的中间目录都必须事先存在。

15、恢复本地修改

svn revert:                 #恢复原始未改变的工作副本文件 (恢复大部份的本地修改)。
revert:
用法: revert PATH...
注意: 本子命令不会存取网络，并且会解除冲突的状况。但是它不会恢复被删除的目录

16、代码库URL变更。

svn switch (sw):            #更新工作副本至不同的URL。
用法: 
1、switch URL [PATH]
2、switch --relocate FROM TO [PATH...]

1、更新你的工作副本，映射到一个新的URL，其行为跟“svn update”很像，也会将 服务器上文件与本地文件合并。这是将工作副本对应到同一仓库中某个分支或者标记的 方法。

2、改写工作副本的URL元数据，以反映单纯的URL上的改变。当仓库的根URL变动 (比如方案名或是主机名称变动)，但是工作副本仍旧对映到同一仓库的同一目录时使用 这个命令更新工作副本与仓库的对应关系。

17、解决冲突

svn resolved:              #移除工作副本的目录或文件的“冲突”状态。
用法: resolved PATH...
注意: 本子命令不会依语法来解决冲突或是移除冲突标记；它只是移除冲突的相关文件，然后让 PATH 可以再次提交。

18、输出指定文件或URL的内容。

svn cat 目标[@版本]...     #如果指定了版本，将从指定的版本开始查找。
svn cat -r PREV filename > filename (PREV 是上一版本,也可以写具体版本号,这样输出结果是可以提交的)