企业官网建设流程全解析

1. 先搞懂SVN是什么，再决定要不要装

SVN（Subversion）是一个集中式版本控制系统，核心思路就是“一个中央仓库，所有人往里面交代码”。跟Git那种分布式模型不同，SVN的每个操作几乎都要跟服务器打交道，所以服务端稳定性和权限控制能力就特别重要。

我带过几个项目组，从Git切回SVN的情况也遇到过。团队里如果有大量非技术角色（策划、美术、文档协同），SVN的学习成本明显更低。很多游戏公司、外包公司、传统软件企业到今天仍然在用SVN，不是因为它潮，而是因为它“够用、好管、权限清晰”。

VisualSVN-Server是Windows环境下最省心的SVN服务端实现。装好之后不用写一行配置命令，界面点点点就能完成仓库创建、用户管理、权限分配。它的底层是Apache + Subversion，但把复杂度全包住了，所以特别适合刚入门的人。

这篇笔记我会从零开始，把VisualSVN-Server的安装、仓库创建、用户配置、客户端接入、IDE集成、常见问题排查全流程讲一遍。所有操作我都在自己的Windows机器上实测过，按着走基本不会踩坑。

2. 安装前的三个思考和两个准备

2.1 为什么选VisualSVN-Server而不是原生Subversion

Windows上装SVN服务端有几条路：直接装SlikSVN命令行版、自己配Apache加载mod_dav_svn模块、用VisualSVN-Server这种集成包。

纯命令行版本对新手不太友好，你得手动敲命令创建仓库、配置httpd.conf，一个空格错了服务都起不来。自己配Apache就更折腾了，先装Apache、再装Subversion、还要改配置、设权限，没有一两个小时下不来。

VisualSVN-Server把所有繁琐环节都封装了。安装过程中自动帮你装好Apache、Subversion、配置好服务、创建好默认仓库目录，安装完就能用。而且自带一个管理控制台，仓库、用户、权限全是图形化操作。对入门者来说，这是Windows下最稳妥的选择。

2.2 版本选型与网络环境

注意我用的词是“网络环境”而不是“软件版本”。VisualSVN-Server目前新版本（5.x以后）默认只支持HTTPS连接，安装包体积也大不少。老项目的客户端可能只支持HTTP协议，这时候就需要选4.x版本。

下载的时候我建议去官网的下载页面，选Standard版（免费）就够了。企业版多出来的那些功能，比如AD域集成、多仓库备份策略，在小团队场景下用不到。官网下载时可能需要填一个邮箱地址，随便填一个能收到链接的就行，下载链不会绑定邮箱，填完立刻能下载。

安装前需要确认三件事：

• 操作系统是Windows 7以上，64位系统优先
• 磁盘空间至少留出1GB给服务端本体，仓库目录另算
• 80或443端口没被IIS或其他Web服务占用（安装时也可以自定义端口）

2.3 安装包的下载路径选择

官网地址是visualsvn.com，下载页面里找到VisualSVN-Server的下载入口。页面会根据你的系统自动推荐安装包，也可以手动切换32位或64位版本。

下载完成后是一个msi格式的安装程序，大约100MB左右。从官网下载速度如果很慢，可以找国内镜像站下载，但一定要对比文件哈希值是否和官网一致。这一点很重要，开发工具类软件就怕被篡改。

3. VisualSVN-Server安装全流程实录

3.1 安装向导的每一步说明

双击安装包后，第一个界面是欢迎页，直接点Next。

接下来是License授权页面，选择“I accept the terms of the license agreement”之后点Next。

然后会进入安装组件选择界面，这一步需要注意。有一个选项叫“Subversion command line tools”，默认是不勾选的。强烈建议勾上，因为这个工具集包含了svnadmin、svnlook这些命令行工具，后面做仓库备份、维护、排查问题都要用到。

下一步会要求选择安装路径和仓库路径。这两个路径建议分开设置，放在不同的物理硬盘或者至少不同的目录下。我就见过有人把仓库路径和程序路径都放在C盘，结果系统崩溃后什么都没了。个人建议程序装在D:\VisualSVN-Server，仓库放在D:\Repositories这样的独立目录。

然后是Network配置页面，最关键的是端口选择。默认使用8443端口以HTTPS方式工作，如果你没有冲突需求就直接点Next。用8443而不是443的好处是：不会被IIS或其他Web服务占用，也不会因为防火墙对88端口之类的特殊限制出问题。

3.2 等待安装的这几十秒里发生了什么

点击Install之后，安装程序会在后台完成这些事情：

• 解压Apache和Subversion相关的二进制文件到安装目录
• 注册一个Windows服务，名字一般是VisualSVN Server
• 生成自签名SSL证书（如果是HTTPS模式）
• 创建默认的仓库根目录和conf配置文件
• 配置防火墙入站规则，放行你选择的端口

这个过程一般1到2分钟就完成了。如果进度条卡在一个地方不动超过5分钟，可能是杀毒软件在扫描安装文件。这个时候把杀毒软件对安装目录的实时监控暂时关掉，再重新跑一次安装程序。

安装完成之后，最后一个界面会有一个“Create initial repository”的勾选选项，默认是选中的，会创建一个名为“Repositories”的示例仓库，直接保留这个勾选，完成安装后可以用来做连接测试。

3.3 安装后的首次启动和验证

安装完成后，桌面上会出现两个快捷方式：“VisualSVN Server Manager”和“VisualSVN-Server”。

打开VisualSVN Server Manager，会看到窗口左边是服务器节点，展开后能看到Repositories、Users、Groups三个分类。右边会显示服务器的基础信息，包括版本号、仓库路径、服务器状态（运行中）。

此时可以做一个最简单的验证：找一台同一局域网内的电脑，浏览器输入https://服务器IP:8443/，会弹出一个SSL证书警告（因为用的是自签名证书），选择“仍然继续”就能看到SVN的欢迎页面。看到这个页面说明服务端已经OK了。

提示：自签名证书的警告会一直在，因为这不是由受信任的CA机构颁发的证书。如果你觉得每次都要点一下很烦，可以在客户端电脑里安装VisualSVN-Server生成的证书文件，把它导入到系统“受信任的根证书颁发机构”里面，警告就消失了。证书文件位置在安装目录下的cert子目录里。

4. 核心配置：创建仓库、用户和权限

4.1 创建第一个代码仓库的正确姿势

在VisualSVN Server Manager左侧右键点击Repositories，选择Create New Repository，会进入仓库创建向导。

Repository Name建议用项目代号或者模块名，比如“ECommerceAPI”。这一步需要想清楚，因为仓库名称会直接出现在访问URL中，后续要修改名称比较麻烦，会改动所有客户端的相对URL。

选择仓库类型时有两种：Empty（空仓库）和Single-project（单项目仓库）。Single-project会在仓库根目录下自动创建一个trunk、branches、tags三个标准目录结构。我强烈建议选择Single-project，这样从第一天起就养成规范的分支管理习惯，不用后面再来补目录。

仓库创建完成后，右侧面板会显示仓库的访问URL。默认是https://主机名:8443/svn/ECommerceAPI/，后面的svn/前缀是VisualSVN-Server的HTTP路径前缀，不要动它。

4.2 用户和用户组的创建逻辑

在Users分类下可以添加用户。创建用户时只需要填用户名和密码，不需要填真实姓名和邮箱。用户名建议用员工工号或者英文拼音。密码方面VisualSVN-Server在5.x版本会强制密码复杂度策略，要求至少6位且包含字母和数字，这个限制可以在服务器属性里关闭。

实际工作中我建议这样做：给每个人都创建独立账号，不要所有人共用一个账号。这样做的原因很直接——出现代码问题的时候，提交日志里能看到是谁提交的，方便回溯。

Groups分类下可以创建用户组。组名的设置建议按项目或者按角色来分，比如“ECommerceTeam”表示项目组成员，“AdminGroup”表示管理员。把用户加入组之后，权限控制就变得特别简单：只需要给组赋予权限，不需要一个个用户去设置。

4.3 路径级权限控制，这是SVN最值钱的功能

在仓库上右键点击Properties，打开权限配置窗口。默认状况下，只有管理员（也就是安装时创建的admin用户）有读写权限，其他人都没有任何权限。

权限配置的核心是“路径级控制”，就是说你可以精确到目录的级别来控制谁能访问、谁能修改。

举个例子：仓库ECommerceAPI下面有trunk、branches、tags三个目录。你可以配置成：

• ECommerceAPI/trunk/：所有开发人员可读写
• ECommerceAPI/branches/feature-xxx/：只有该特性的负责人可读写
• ECommerceAPI/tags/：所有开发人员可读，但只有管理员有写权限（标签不能随意修改）

配置方式就是先选择左边路径（比如仓库根目录下的某个目录），然后在右边勾选对应的用户或组权限。权限有三个等级：

• No Access（不可访问）
• Read Only（只读）
• Read / Write（读写）

一个常见的踩坑点在这里：假设某个用户对仓库根目录是“No Access”，但对/trunk目录设了“Read / Write”，最终效果是用户仍然无法访问trunk，因为SVN的权限继承规则是从根目录往下逐级判断的，如果有任何一级检查不通过，就会被拒绝。

解决方案：对仓库根目录按组去控制，开发人员的组在根目录给“Read Only”，然后对具体子目录单独放开“Read / Write”。这样根目录有只读权限，子目录有完全权限，逻辑是最顺的。

5. 客户端接入：TortoiseSVN安装与汉化

5.1 小乌龟（TortoiseSVN）的安装细节

服务端配好了，接下来就是客户端安装。Windows上最经典的SVN客户端是TortoiseSVN，因为图标是一只小乌龟，大家习惯叫它小乌龟。

官网下载的时候注意32位和64位版本必须跟操作系统位数一致。还有一个小细节：TortoiseSVN的主程序只支持英文界面，简体中文是独立的中文语言包。所以实际上你需要下载两个文件：

• TortoiseSVN-x.x.x-x64.msi（主程序）
• TortoiseSVN-LanguagePack-x.x.x-x64-zh_CN.msi（中文包）

先装主程序，再装语言包。安装语言包完成后，在桌面空白处点右键，找到TortoiseSVN -> Settings，打开设置窗口，在Language下拉框里选择“中文（简体）”，确定后重开右键菜单就是中文了。

提示：必须严格匹配主程序和语言包的版本号。比如主程序是1.14.6，那语言包也必须是1.14.6。版本不一致会导致语言包无法安装，或者安装了也不生效。

5.2 把远程仓库拉到本地（SVN Checkout）

安装好客户端之后，找一个空文件夹，这个文件夹就是你的“工作副本”。

右键 -> SVN Checkout，在弹出的窗口里填入仓库的URL，比如“https://192.168.1.100:8443/svn/ECommerceAPI/”，Checkout directory如果你是右键在文件夹里操作的，会自动填上。

如果连的是自签名证书的服务器，第一次会弹出一个证书确认框，选择“永久接受”即可。如果出现“Server certificate verification failed”并且按钮是置灰的，一般是因为证书有效期问题或者主机名不匹配，这个我在后面的问题排查章节细说。

Checkout成功之后，文件夹里的文件会带上绿色对勾的角标，表示这些文件和服务器上的版本是一致的。

5.3 日常操作：提交、更新、冲突处理

后面日常开发中，你只需要记住这三个操作：

• SVN Update：从服务器拉最新代码到本地。开始写代码之前先更新一下，这是SVN玩家的基本素养。
• SVN Commit：把本地修改提交到服务器。提交前先右键查看Diff，确认改的都是该改的，然后在提交信息里写清楚改了什么。
• SVN Check for modifications：查看本地工作副本相对于服务器的改动情况。这个功能很好用，能看到哪些文件被修改了、哪些是新加的、哪些被删除了。

会遇到一个经典问题：冲突。两个人同时改了同一个文件的同一个地方，先提交的人成功，后提交的人更新时会看到“conflicted”状态。这时候不要慌，TortoiseSVN会在冲突文件旁边生成三个临时文件（文件名带mine、r数字等后缀），双击冲突文件会弹出合并工具，你手动选择保留谁的代码。

我个人的建议是：更新代码时养成看颜色的习惯。红色感叹号表示文件被修改了，黄色感叹号表示有冲突，灰色对勾表示没有变化。每天到岗第一件事先右键SVN Update，下班前SVN Commit，就不会出大问题。

6. 与IDEA集成：在IntelliJ IDEA里配置SVN

6.1 IDEA配置SVN客户端路径

用IDEA开发的Java程序员不能用小乌龟做主力，因为小乌龟的命令行操作IDE不认。IDEA集成SVN的方式是通过命令行客户端，所以在IDEA里使用SVN之前，必须先装一个SVN命令行工具。

这里有个坑：TortoiseSVN从很早的版本开始就不带命令行工具了。所以你需要单独安装一个SlikSVN或者CollabNet的SVN命令行版本。我常用的是SlikSVN，下载后一路Next安装。

装好后，打开IDEA设置：File -> Settings -> Version Control -> Subversion，找到“Use command line client”一项，后面有个浏览按钮，选择到sliksvn安装目录下的bin目录里的svn.exe。比如C:\Program Files\SlikSvn\bin\svn.exe。

配置完成后点击OK。如果IDEA右下方出现一个提示“Subversion integration is enabled”，就说明配置成功了。

6.2 IDEA中拉取项目并管理提交

在IDEA里拉取SVN项目：File -> New -> Project from Version Control -> Subversion，输入仓库URL，选择本地存放目录，点击Checkout即可。

项目打开后，IDEA会自动识别版本信息，文件颜色会变成绿色（新增）、蓝色（修改）、灰色（删除）。这些颜色在Setting -> File Colors里可以自己调。

提交代码的时候，右键项目或文件选择Subversion -> Commit Changes，IDEA会列出所有修改的文件，输入提交信息后点击Commit。

有一点要特别注意：IDEA的Enable/Disable（启用/停用）SVN按钮在Version Control工具栏里。如果项目没有被自动识别为SVN项目，可以在顶部的VCS菜单里选择Enable Version Control Integration，然后选择Subversion。

6.3 IDEA里SVN的日常操作小习惯

IDEA里最常用的几个图标：

• 蓝色向下箭头：更新文件
• 绿色向上箭头：提交文件
• 钢笔图标（Show Diff）：查看文件差异

实际工作中我习惯先Ctrl+K调出提交框，但已经足够用了）。提交之前先用右上角的“分栏显示”模式看一下Diff，确认没有把不该提交的配置改进去。

还有一个技巧：IDEA里修改的文件如果同时在外部小乌龟里做了操作，最好在IDEA里同步一下。它们之间偶尔会因为缓存问题出现状态显示不一致，刷新或者重新打开项目可以解决。

7. 常见问题与排查技巧实录

7.1 连接失败，SSL证书报错

这是最最常见的问题，症状是第一次访问SVN服务器时，客户端或者浏览器提示证书不受信任。

原因：VisualSVN-Server默认使用自签名证书，不受外部CA信任。解决办法有两个路径：

路径一（推荐）：如果是内网固定环境，在TortoiseSVN首次连接时选择“永久接受”（Permanently accept），浏览器里选择“仍然继续”，IDEA里点击“Proceed”。基本都是一次性操作，以后不会再问。

路径二（严谨方案）：把服务器的证书导出，在客户端电脑上双击导入到“受信任的根证书颁发机构”。具体操作是：打开VisualSVN Server Manager，右键服务器选Properties，找到证书那一栏，点“View Certificate”，然后切换到“详细信息”选项卡，点“Copy to File”导出成cer文件。拿到客户端电脑上双击，安装位置选“本地计算机”，存储区域选“受信任的根证书颁发机构”。

7.2 权限配置好了，用户还是没权限

这个我也碰到过，明明在仓库权限窗口里对某个用户设置了“Read / Write”，但用户访问还是提示没有权限。

排查顺序是这样的：

先看用户是否在同一个仓库的其他路径上有“No Access”设置。SVN权限是逐级匹配的，根目录或者父目录的No Access会覆盖子目录的所有权限。把父目录权限先改成Read Only，再在子目录单独设置。

再看仓库属性里的“Repository access”界面，确认是否勾选了“All users have read access”之类的全局选项。有时候全局选项和具体权限设置互相冲突。

最后看用户是否被误加入了某个权限更高的组，不同组之间也可能产生权限叠加的冲突。右键用户，查看属于哪些组，然后逐组排查。

7.3 工作副本状态显示异常

文件明明没有修改，但图标显示成红色感叹号（Modified）；或者文件改了，但仍然显示绿色对勾。

这种情况通常是因为TortoiseSVN的文件状态图标（Icon Overlay）被其他软件干扰了。Windows系统的图标叠加最多支持15个，如果装了很多网盘软件（OneDrive、坚果云、Dropbox），可能把SVN的图标挤掉了。

解决办法：

• 右键 -> TortoiseSVN -> Settings -> Icon Overlays，把“Show overlays for network drives”和“Show overlays on shell context menu”都勾上
• 如果还是不显示，考虑卸载不常用的云盘软件
• 最彻底的办法是使用TortoiseSVN的“Refresh”（右键菜单里）强制刷新状态

7.4 一台电脑同时用SVN和Git的共存体验

很多开发者的电脑上会同时装小乌龟（TortoiseGit）和小乌龟SVN（TortoiseSVN）。这两个工具兼容性其实还不错，右键菜单会有各自的选项，不会互相干扰。唯一需要注意的是：不要在同一个工作目录上同时初始化SVN和Git，两个版本控制系统的管理文件会互相污染，轻则状态显示错乱，重则文件被误删。

正确做法是一个项目用一种版本控制，仓库目录不要嵌套。如果公司里既有SVN项目又有Git项目，把两个项目的本地工作目录分开，互相不交叉。

8. 关于SVN使用的几点经验和体会

做版本控制，最重要的不是工具本身，而是团队的使用习惯。

SVN的集中式模式天然适合“中心是唯一真理”的项目管理。它比Git容易上手的地方在于：你不用理解“分支”和“合并”在分布式环境下的复杂度。SVN的分支本质上是目录拷贝，创建和合并的思维模型都非常直观。

我用SVN管项目这几年，最大的体会是权限控制的必要性。可以精确到某个配置文件只允许指定的人修改，这在跟外包团队或者跨部门协同的时候帮了大忙。团队里有几个误删过公共代码的开发，在SVN的权限控制面前，这种事故基本能被堵住。

从跟队经验来看，新人加入SVN项目的适应时间通常是半天，而加入Git仓库项目需要两到三天。如果你是带项目的人，团队成员以非纯程序员为主，SVN仍然是提高协作效率的理性选择。

最后分享一个小技巧：在做关键节点（比如发版前）的时候，建议给仓库打个Tag，路径是右键trunk目录选择Branch/Tag操作，把trunk的内容复制到tags/v1.0.0。以后不管怎么改，都能随时回滚到发版那天的代码。这个习惯配合SVN的集中式备份，能让项目长期运行不出大乱子。