SVN使用指引（本地服务器为Windows）

墨蓝 2022-07-14 01:16 146阅读 0赞

## 1. 安装SVN客户端 ##

使用SVN进行文件上传前，请在您的本地PC上安装SVN客户端。推荐使用1.7版本的SVN客户端。请不要升级到1.8版本，TortoiseSVN 1.8版本存在缺陷，可能会导致SVN同步异常。  
本地服务器为Windows时，推荐使用TortoiseSVN，下载地址：[http://sourceforge.net/projects/tortoisesvn/files/][http_sourceforge.net_projects_tortoisesvn_files]   
下面的操作指引都以TortoiseSVN为例。

## 2. 创建本地目录并连接到SVN库 ##

1. 在您的本地机器上新建一个目录，例如“MyApp”，如下图所示：  
![SVN\_2.png][SVN_2.png]   
2. 进入该文件夹，鼠标右键点击空白处，在邮件菜单中选择“SVN Checkout...”，如下图所示：  
![SVN\_3.png][SVN_3.png]   
3. 在弹框里填入您的应用的SVN库的路径（你可能需要了解[如何获取SVN仓库地址][SVN]），弹框中的其它选项保持默认，如下图所示：  
![SVN\_4.png][SVN_4.png]   
4. 点击弹框中的“OK”按钮，首次登录时要求输入该SVN版本库的用户名和密码（即应用的云服务账号和密码，您可能需要了解[如何查看云服务账号和密码][Link 1]）。  
登录框如下图所示：  
![SVN\_21.png][SVN_21.png]   
注意不要勾选下面的“Save authentication”，原因是如果1个开发者有多个应用，则有多个SVN库，保留1个SVN库的登录凭证可能会导致登录别的SVN库失败。  
如果失败，请选择右键菜单的“TortoiseSVN”->“Settings”->“Save Data”对话框中，点击“Authentication data”旁的“Clear”按钮，清除登录凭证。 清除登录凭证如下图所示：  
  
![SVN\_22.png][SVN_22.png]   
  
5. 通过验证后，即开始从SVN库中checkout该SVN库里的所有文件。如下所示：  
![SVN\_5.png][SVN_5.png]   
6. Checkout成功后，即可在本地机器“MyApp”目录下看到该SVN库下的所有文件。  
注意，对于CEE SVN库来说：  
（1）如果输入的SVN库路径是该应用的SVN库地址，则checkout出该应用所有的WebService下的所有版本的代码。MyApp目录下是您的应用下所有的WebService的目录，每个WebService是1个文件夹。   
![SVN\_7.png][SVN_7.png]   
（2）如果你输入的是您的应用的1个Web服务下的1个版本的SVN路径，则只会checkout出该版本下的代码。每个WebService下是所有的版本目录，每个版本是1个文件夹。  
![SVN\_8.png][SVN_8.png]   
（3）在您还没有上传任何代码到SVN库之前，这里checkout出来的只是目录，版本目录下是没有文件的（除了自动生成的.svny文件夹以及index.html ）。  
![SVN\_9.png][SVN_9.png]

## 3. 提交文件 ##

1. 将您需要提交的复制到本地对应的目录下。  
例如您需要将文件“test2.php”上传到Web服务“helloc”下的版本“1”里，则需要将您的应用程序复制到“MyApp/10507/helloc/1”目录下。如下图所示：  
![SVN\_10.png][SVN_10.png]   
2.右键点击文件“test2.php”，选择“TortoiseSVN -> Add”菜单，即将刚才复制的代码添加到SVN工作目录中。  
（只要是新增了文件，在提交前都必须先“add”，否则SVN不识别该文件） 如下图所示：  
![SVN\_11.png][SVN_11.png]  
add成功后，该文件的图标变成蓝色的十字，如下图所示：  
![SVN\_12.png][SVN_12.png]   
3. 然后右键点击文件“test2.php”，选择“SVN Commit..”菜单，然后填写本次提交的日志（必填项，不填将导致提交失败），即将刚才复制的代码提交到SVN工作目录中。  
如下图所示：  
![SVN\_13.png][SVN_13.png]   
![SVN\_14.png][SVN_14.png]   
![SVN\_15.png][SVN_15.png]   
4. 提交成功后，该文件的图标会变为绿色的对勾，如下图所示：  
![SVN\_16.png][SVN_16.png]

## 4. 修改文件 ##

1. 您可以直接在本地使用编辑器打开SVN工作目录下的某个文件并进行修改，修改完成后，可以看到该文件的图标变成红色的感叹号，如下图所示：  
![SVN\_17.png][SVN_17.png]   
2. 右键点击该文件，选择“SVN Commit...”，并填写本次提交的日志（必填项，不填将导致提交失败），即将该更新提交到SVN库。  
3. 对于CEE SVN库来说，对于当前生效版本，我们强烈建议您在提交前需保证所做的修改已经通过了测试，以避免影响现网服务。

## 5. 历史版本回滚 ##

SVN服务器天然支持版本管理，因此如果开发者需要对某些历史版本进行回滚，可以直接在SVN客户端上进行历史版本回滚操作，将历史版本的目录或文件下载到本地服务器，然后再提交到SVN服务器即可。   
详细说明如下：  
1. 在需要进行历史版本回滚的目录或文件上，点击右键，选择菜单“TortoiseSVN”->“Show log”，如下图所示：   
![SVN\_18.png][SVN_18.png]

2. 在打开的“Log Messages”面板中，右键选中你要回滚的版本，在出现的右键菜单中选择“Revert to this revision”，即可执行回滚操作。如下图所示：  
![SVN\_19.png][SVN_19.png]

3. 回滚成功后，本地的目录或文件就被历史版本的目录或文件替代，可看到其图标变成红色的感叹号。

4. 开发者需要将该目录或文件提交到SVN服务器上，即右键选中该目录或文件，然后选择菜单中的“SVN Commit...”将文件提交到服务器。提交成功后，即完成历史版本的回滚。

## 6. 删除文件 ##

步骤如下：  
1. 在需要删除的目录或文件上，点击右键，选择菜单“TortoiseSVN”->“Delete”，如下图所示：  
![SVN\_20.png][SVN_20.png]   
2. 点击“Delete”后，可以看见本地已经不存在该文件或目录。  
3. 右键点击已删除文件原来所在的目录，选择“SVN Commit...”，并填写本次提交的日志（必填项，不填将导致提交失败），提交到SVN库。

## 7. 其它操作 ##

SVN的操作与一般的SVN操作是一致的，这里不再列举，您可以参考[SVN手册][SVN 1]。

[http_sourceforge.net_projects_tortoisesvn_files]: http://sourceforge.net/projects/tortoisesvn/files/
[SVN_2.png]: /images/20220714/ea08b6e98ff3412bbef31e59f66be353.png
[SVN_3.png]: /images/20220714/e3113f2146e24b91841c02ae7c44604f.png
[SVN]: http://wiki.open.qq.com/wiki/SVN%E7%AE%80%E4%BB%8B%E5%8F%8A%E4%BD%BF%E7%94%A8%E9%99%90%E5%88%B6#5._SVN.E5.BA.93.E5.9C.B0.E5.9D.80.E8.AF.B4.E6.98.8E
[SVN_4.png]: /images/20220714/44eb312bbcf9493a93263f3f56b311f2.png
[Link 1]: http://wiki.open.qq.com/wiki/%E4%BA%91%E6%9C%8D%E5%8A%A1%E8%B4%A6%E5%8F%B7%E7%AE%A1%E7%90%86_V2
[SVN_21.png]: /images/20220714/d608e8833175433c89bbfd5cbc15e046.png
[SVN_22.png]: /images/20220714/6b6028a6271f4520858245e9c43f5267.png
[SVN_5.png]: /images/20220714/bf5ea546cc334f5dbd1272aa12e3d5f8.png
[SVN_7.png]: /images/20220714/cd230c853b7f49338de6b01ae0e29b6c.png
[SVN_8.png]: /images/20220714/43b9831659c94320b48b7db12a2e48b4.png
[SVN_9.png]: /images/20220714/43c6d8303e3446fcb4058a44cf563913.png
[SVN_10.png]: /images/20220714/ce227c9e5db74243b4cdd1a30e0b349b.png
[SVN_11.png]: /images/20220714/7d2f7f7f7bc349ba9c4d450bd0a45009.png
[SVN_12.png]: /images/20220714/ed2b7ec4324545a9a67c2599cecb85ce.png
[SVN_13.png]: /images/20220714/d601253a9fa94566b24e997ce12532b1.png
[SVN_14.png]: /images/20220714/4ba2bdce1a624537b1fc59868fc4427e.png
[SVN_15.png]: /images/20220714/15844b18fa9e45e08904650470430e1e.png
[SVN_16.png]: /images/20220714/c9b3154444764b3296085a1e47258152.png
[SVN_17.png]: /images/20220714/896423bf6c7144c784f7c50865368335.png
[SVN_18.png]: /images/20220714/fa4ad06f071f48ae97feeecc47d52502.png
[SVN_19.png]: /images/20220714/688927e2b569492aa7f9bbe64001f8b4.png
[SVN_20.png]: /images/20220714/9ca6c637b5cb4aed8d6a72dec55464cd.png
[SVN 1]: http://svndoc.iusesvn.com/