前言

版本控制工具就是记录项目代码文件夹和文件的每一个改动，并为每次改动编上序号（也叫版本号），用于存储，跟踪文件夹和文件的修改历史的工具。通过版本控制，可以恢复文件的旧版本并查看历史-谁在什么时间如何进行的修改。

目前主流的版本控制工具：Git和VSN。本学习笔记是SVN学习笔记，因为我在的公司就用这个。

SVN实践笔记

第一章 对于SVN的一些观念

1.1 SVN概述

SVN是Subversion的简称，是一个开放源代码的版本控制系统，是用于多个人共同开发同一个项目，共用资源的目的。

版本库：Subversion使用集中的数据库，它包含了所有的版本控制文件及其完整历史。这个数据库就是版本库。版本库通常位于运行 Subversion 服务器的文件服务器上，向 Subversion 客户端提供需要的数据。

工作副本：这是实际工作的地方。每一个开发者在自己的电脑上都有属于自己的工作副本。可以通过Subversion客户端将最新的版本从版本库上取下来，在本地的副本上工作而不影响其他人，如果对更改满意就可以将其提交到版本库中。

1.2 SVN工作流程

1.搭建svn服务器：安装服务器端软件、创建项目仓库、启动仓库服务

2.在个人开发电脑，安装svn客户端软件

3.创建项目目录，通过checkout检出操作，与svn版本库建立连接，下载所有的代码

4.日常开发，通过commit提交操作，将本地的修改，提交到svn版本库

5.其他人提交过代码，可以通过update更新操作，将版本库中最新的代码（被修改部分）更新到本地。

注意：svn服务器的地址 svn://IP , 由服务器搭建服务器的ip地址和相关目录组成，由搭建者管理

1.3 SVN优势（强项）

1.多人协作开发（解决代码合并覆盖问题）

2.版本退回（将一个或多个文件恢复到旧版本）

3.查看修改历史（日志），方便把控开发进度

1.4 SVN工作原理

第二章 SVN服务器端常用操作之创建仓库和建立连接

2.1 创建 SVN项目（仓库）

创建svn版本库命令：svnadmin create "仓库地址"

在Windows中打开cmd输入命令执行即可。

执行命令成功后，仓库地址中创建好相应的仓库文件夹。

Linux服务器上通过命令行就能创建，而Windows中有时候执行命令会出现错误。解决方式有：

1.将svn服务器端安装目录设置到环境变量中

2.将svnadmin.exe拖到命令行窗口或者书写完整路径，加上 create “仓库地址” 执行

2.2 启动仓库服务

使用SVN版本库前要启动SVN仓库服务，命令是：svnserve -d -r "仓库地址"

执行成功后，光标换行并持续闪烁，这叫“挂起”状态，表示Svn仓库服务已启动，不能关掉执行命令的窗口，想要别的操作新窗口操作。

SVN使用的协议是SVN协议，协议地址格式：svn://localhost 指向 仓库目录

2.3 设置仓库的匿名读写权限

SVN默认使用匿名用户，只有读（read）的权利，只能执行检出和更新操作。

需要手动设置匿名用户写入权限，才能执行提交操作。

配置文件是SVN仓库目录中conf目录下的svnserve.conf文件，在第19-20行有注释文件，可以取消注释，最好自己写一个,注意这里不能再语句后写注释：anon-access=write

第三章 SVN客户端常用操作

3.1 给仓库提交程序

我的开发环境是为Windows，相关操作如下：

1.在自己写代码的文件中创建一个工作副本（workspace），创建自定义文件名，进入目录，鼠标右键->svn checkout,打开checkout界面，填写SVN仓库地址和工作副本地址提交即可。

2.检出成果后，工作副本中就会出现.svn隐藏目录，这是SVN对当前目录下的文件进行版本控制的，相当于管理员，不能动里面的内容（禁止修改，删除）。

3.在工作副本中，开发相应的程序文件（test.html）选中文件，鼠标右键->TortoiseSVN ->Add 操作，表示将文件添加到svn版本控制范围，将文件标记为已添加状态,再次选中文件，右键-> SVN Commit 打开提交界面，填写版本说明（日志），选中要提交的文件，ok即可。

4.成功后版本号自动加1，第一次提交的就是第一个版本。

3.2 常用操作指令

1.Checkout检出指令:

从版本库检出仓库项目文件，一般只在第一次从版本库下载代码时执行，一般在一个空目录中执行。

2.Commit提交指令

将本地的更改提交到版本库。根据实际情况进行提交，一般在下班前至少提交一次。

3.Update更新指令：

从版本库更新最新的文件，一般在上班后先执行一次，或者每次开发一个新的功能前执行一次。

4.Add添加指令：

将一个新增的文件标记为已添加，会出现在提交列表并默认选中。

3.3 文件和目录的提交

可以对文件和目录单个进行添加和提交操作，也可以进行批量提交。

提交方式：在最顶层目录 空白处右键->SVN Commit 打开提交界面，手动选中要提交的文件，点击ok进行提交，提交成功版本号+1

注：提交列表中，只会出现新增的文件目录或者修改过的文件目录。

3.4 SVN图标集

常规图标：当本地文件与服务器端文件完全同步时，系统显示常规图标

冲突图标：如果两个程序员同时修改同一个文件，系统在上传时就会显示冲突图标

已删除图标：服务器文件已删除，本地就会显示删除图标

增加图标：文件还未上传但是已经添加到上传的队列中

无版本控制图标：当前文件是新建的，还未上传

修改图标：如果本地文件有修改但未上传就显示修改图标

只读图标：服务器端文件如果设置为只读，客户端就显示只读图标

锁定图标：如果服务器端文件已锁定，本地就显示锁定图标

忽略图标：有的电脑图标可能不显示，如果某些文件与项目无关，可以添加到忽略列表

第四章 SVN使用注意事项

4.1 查看日志

查看日志（版本说明）：空白处右键-> TortoiseSVN ->show log 查看日志

4.2 忽略文件

忽略文件：在开发过程中，项目文件夹（工作副本）中，可能会出现一些和项目代码没有直接关系的文件，没必要添加到svn版本库中去。可以对这些文件设置为忽略文件。

设置方式：选中要忽略的文件 -> 右键 -> TortoiseSVN -> add to ignore list 添加到忽略列表,其中四个选项：

文件名.后缀 忽略当前目录中的指定文件

*.后缀 忽略当前目录中的指定后缀的所有文件

文件名.后缀（recursively） 忽略当前目录以及子目录中的指定文件

*.后缀（recursively） 忽略当前目录以及子目录中的指定后缀的所有文件

对某个文件设置为忽略文件后，其不会出现在提交列表中。设置为忽略文件之后，一般可以通过反向操作，取消忽略的设置

选中要忽略的文件 -> 右键 -> TortoiseSVN -> remove from ignore list 从忽略列表移除

4.3 版本退回

回退版本：空白处右键 -> TortoiseSVN -> update to revision 更新至版本可以直接输入版本号，或者点击show log去选中一个指定版本。

关于版本退回特别说明：

注意：版本回退功能，只是将本地工作副本中的内容，更新到了一个指定版本，svn版本库中还是有最新的代码，除非提交版本退回文件。

版本回退功能，只用于获取某一个历史版本的代码，并且备份用于其他用途。

不要在版本回退后的历史版本中直接进行开发。可以先通过svn update指令更新到最新的代码，再进行开发。

4.4 版本冲突

多个人同时对同一个文件做修改，并且修改在同一行。先后提交到版本库时，第一个人提交成功，版本号+1，其他人提交时，svn会提示必须先更新到最新版本再提交。如果其他人在本地工作副本进行更新，svn会提示发生了冲突。

冲突的模拟：在本地检出两个工作副本，模拟两个人同时开发。两个工作副本先都更新最新的版本，然后先后更改代码并提交。
两个表现：一是发生冲突的文件中，包含了多个版本的代码;二是目录中发生冲突的文件多出来几个不同后缀版本的文件

发生了版本冲突后没法提交文件，必须先解决冲突然后再提交到版本库。

处理版本冲突问题一般直接能够区分头儿和小弟的。因为难且重要。

解决版本冲突的方式：

1.继续提交本地的修改，使用svn resolve操作,修改发生冲突的文件中的代码，保留指定的代码（删除冲突标记行）。选中发生冲突的文件，右键-> TortoiseSVN -> resolve 解决,打开解决冲突界面,选中要解决冲突的文件，点击ok;将指定的文件设置为已解决状态，因冲突产生的多余的文件都被自动删除;继续执行svn commit提交操作即可。

2.放弃本地的修改，使用svn revert操作 将指定文件还原成最新版本,选中发生冲突的文件，右键->TortoiseSVN -> revert 还原 打开还原界面,选中要还原的文件，点击ok， 放弃本地的修改，并将指定文件变为最新版本,适合用于少量代码修改;

版本冲突只是发生在本地的工作副本的，版本库中并没有版本冲突，因为有冲突文件无法提交。

4.5 配置多仓库

在开发过程中，通常可能同时开发多个项目，都是用svn来进行管理。每个项目对应着对应的版本库。

使用svn客户端进行检出操作时，需要使用到svn版本库的地址svn://ip/目录，这个地址在启动svn仓库服务后，指向了启动服务时指定的目录。一个地址只能指向一个目录。

配置方式：

在启动svn仓库服务时，仓库地址指向多个版本库的共同的上级目录(父级目录)。也就创建仓库时将svn://ip地址指向共同目录

#创建项目1仓库
svnadmin create "共同目录/项目1"
#启动SVNserve大目录
svnserve -d -r "共同目录"
#重新开一个新命令窗口，不需要启动SVNserve目录
svnadmin create "共同目录/项目2"

命令说明：

1.对于已经在使用的项目1仓库，需要将仓库地址重新定位到svn://ip/项目1定位方式 空白处右键->TortoiseSVN -> relocate 重新定位点击ok确认进行重新定位，之后可以正常使用。

2.对于准备使用的项目2仓库，检出时直接使用svn://ip/项目2地址。

注意：检出操作必须在一个空文件夹中进行。

4.6 权限控制

svn提供了一个可选的权限控制功能，可以限制用户的访问权限。权限控制分为两部分：认证（Authentication）和授权（Authorization）

认证文件：鉴别用户身份，可以设置用户名和密码（passwd）

授权文件：判断用户是否具备某种操作（读写）的权限（authz）

注意：版本库的配置文件，只对当前版本库生效，每个版本库都有自己的配置文件。

权限控制设置步骤：去掉注释，顶格，等于开启相应权限，不能有任何无关字符
1.修改svnserve.conf，关闭匿名用户的访问权限:anon-access=none

2.修改svnserve.conf，开启认证文件，开启授权文件:password-db=passwd（开启认证），authz-db=authz（开启授权）。

3.修改passwd文件，设置用户名和密码

#格式：用户名=密码
ak=ak1234
aklman=aklman1234
ahmatbek=ahmatbek1234

4.修改authz文件，设置哪些用户具有哪些权限:

第一种方式：给指定用户直接授权;

#1.指定仓库名称，如果使用单仓库，仓库所在目录设置为[/];如果使用了多仓库，仓库所在目录设置为[项目1：/]
[项目1：/]
#2.格式：用户名=权限
ak=rw
aklman=r
ahmatbek=rw

第二种方式：对用户进行分组，对分组统一授权

#1.格式：分组名称=用户名1，用户名2
T5=aklman,ahmatbek
T4=ak,xiaoming
#2.指定仓库名称，如果使用单仓库，仓库所在目录设置为[项目/];如果使用了多仓库，仓库所在目录设置为[项目1：/]
[项目1:/]
#3.给分组授权
@T5=rw
@T4=r

5.完成以上设置之后，重新在工作副本中，进行svn的相关操作，会提示需要先认证：

填写正确的用户名和密码进行认证，可以选择记住认证信息，以后不需要进行重复认证，否则每一次都需要进行认证。

4.7 清除保存的认证信息

保存认证信息后，如果因为一些原因比如修改了密码，需要重新进行认证，需要先清除保存的认证信息才能打开认证界面。

清楚方式：空白处右键 -> TortoiseSVN -> settings设置 打开设置界面，在左侧找到Saved Data点击，在右方找到Authentication data ,点击后面的清除按钮进行清除。

第五章 SVN自动服务器与批量处理执行

5.1 为什么需要自动启动服务

使用svn仓库，需要先启动仓库服务，必须保持命令行窗口的挂起状态，如果关闭窗口，则仓库服务会停止。这种方式不太友好，更好的方式，将svn仓库服务设置为开机自启动的服务。

5.2 创建自动创建服务

创建自启动服务，通过以下命令实现：

#windows中，1.必须使用管理员身份打开命令行窗口；2.箭头位置必须放置一个空格，否则创建会失败
sc create svn binPath= "F:\Subversion\svnserve.exe -r F:\svncangku --service" start= auto
#Linux中，只启动一次永久有效，除非关掉
sudo svnserve -d -r /home/data/svn/

--service 表示其为服务项目，start= auto表示电脑开机就自动启动该服务

创建成功之后，下次重启电脑，svn仓库服务会自动启动（偶尔可能会自动启动失败，需要手动启动），可以在计算机的服务界面查看相关服务（右键计算机-> 管理->服务）。

5.3 批处理指令

1.net start svn 启动svn服务

2.net stop svn 停止svn服务

3.sc delete svn 删除svn服务（记住：svn如果需要删除必须先停止）

可以通过以上命令在cmd窗口中执行（这些命令也必须以管理员身份打开cmd窗口）

可以将在cmd命令行执行的命令，保存到一个.bat后缀的文件中，这就是批处理文件;需要执行对应命令时，直接运行对应的批处理文件。如：开启

net start svn

需要开启svn服务时，直接以管理员身份运行svnstart.bat即可。

第六章 钩子程序同步代码

6.1 钩子程序原理

当项目开发到一定阶段，部署到另外一台服务器的apache下运行后。如果继续对项目进行开发，将新的代码提交到版本库，另外服务器的apache下的代码，需要执行svn更新操作，才能得到最新的代码。

为此Svn提供了一个钩子程序同步代码的功能，可以通过一些设置，每当svn版本库中有更新，则在指定服务器apache项目目录中自动执行svn update命令。

6.2 使用同步钩子(post-commit)程序

使用同步钩子的步骤：

1.在服务器端apache下创建一个文件夹用于接收同步数据

2.在本地和服务器端同时检出或者更新svn仓库最新数据

3.打开服务器的项目1仓库，找到hooks钩子目录，新建post-commit.bat批处理文件，然后输出如下代码

#SET SVN=”F:\Subversion\svn.exe”  设置svn指令目录
#SET DIR=”F:\workspace\online”  设置需要同步的目录
#SVN update %DIR% --username username --password password  使用update指令更新数据到同步目录

SET SVN="F:\Subversion\svn.exe"
SET DIR="F:\workspace\online"
SVN update %DIR% --username aklman --password aklman1234

参考资料

版本控制笔记