Windows系统安装配置Subversion（SVN）完整教程：从客户端到本地服务器一步到位

Subversion（简称SVN）是一款经典的集中式版本控制工具，很多团队和老项目至今还在用它管理代码。Windows用户装SVN其实不复杂，但新手经常卡在安装路径、权限、客户端选择这些地方。这篇教程直接从零开始，带你把Windows下的SVN客户端和本地服务器都搭好，适合完全没接触过版本控制的电脑小白。

一、先搞清楚：Windows上用SVN到底需要什么

SVN分客户端和服务器两部分。

• 客户端：用来检出代码、提交修改、查看历史。Windows上最推荐TortoiseSVN（带右键菜单，操作直观）。
• 服务器：用来存放仓库。如果你只是个人练习，或者公司已经有现成服务器，只装客户端就够了。如果要自己本地建一个仓库给同事用，就需要额外装服务器软件。

常见免费方案：
客户端：TortoiseSVN + 官方命令行工具
服务器：VisualSVN Server（免费版够用）或者直接用Apache + Subversion源码包（稍麻烦）。

下面分两部分讲，先装客户端，再讲本地服务器。

二、Windows安装SVN客户端（TortoiseSVN）详细步骤

1. 下载正确版本

打开浏览器搜索“TortoiseSVN官网”，进入下载页面。
注意看自己系统是32位还是64位：

• 右键“此电脑”→属性，看“系统类型”。
• 下载对应位数的安装包，建议选最新稳定版。
  同时勾选下载“command line client tools”，这样后面命令行也能用。

2. 安装过程（一步一步点）

1. 双击下载好的.msi文件，点“Next”。
2. 选择安装路径，建议不要放C盘根目录，可以改成D:\Program Files\TortoiseSVN。
3. 组件选择界面：
   • 默认勾选“TortoiseSVN”和“command line client tools”。
   • 如果需要中文界面，再勾选“Language packs”里的“Chinese (Simplified)”。
4. 一路Next，最后点Install。安装过程大约2-5分钟。
5. 安装完成后重启电脑（必须重启，否则右键菜单不生效）。

3. 验证是否安装成功

重启后，在任意空白处右键，应该能看到“SVN Checkout”“TortoiseSVN”菜单。
打开命令提示符（Win+R输入cmd），输入：

svn --version

如果显示版本号，说明命令行工具也装好了。

三、最常用操作：从仓库检出代码并提交

假设公司已经给了你一个SVN地址，例如：https://svn.example.com/project/trunk

1. 检出（Checkout）代码

1. 在想放代码的文件夹空白处右键 → SVN Checkout。
2. URL of repository：粘贴仓库地址。
3. Checkout directory：选择本地路径，比如D:\work\project。
4. 点OK。第一次会弹出用户名密码窗口，输入后勾选“Save authentication”，以后就不用重复输。
5. 等待下载完成。文件夹里会出现一个绿色对勾的图标，说明检出成功。

2. 修改文件后提交（Commit）

1. 修改完代码，在项目文件夹右键 → SVN Commit。
2. 弹出窗口会列出所有改动文件，勾选要提交的，在Message里写清楚改了什么（例如“修复登录页验证码显示问题”）。
3. 点OK。提交成功后图标变回绿色。

3. 更新别人最新代码（Update）

每天开工前，在项目文件夹右键 → SVN Update。
如果提示冲突，TortoiseSVN会用不同颜色标出来，双击冲突文件就能用合并工具处理。

4. 查看历史和回退

右键文件 → TortoiseSVN → Show log，能看到所有提交记录。
需要回退某个版本时，选中对应日志，右键 → Revert to this revision。

四、自己搭建本地SVN服务器（适合小团队或学习）

如果只是自己玩，或者几个人在局域网协作，推荐用VisualSVN Server，安装简单、带图形界面。

1. 下载安装VisualSVN Server

搜索“VisualSVN Server下载”，选免费Standard版。
安装时注意：

• 选择“VisualSVN Server and Management ConSole”。
• 仓库默认路径建议改成D:\Repositories（别放系统盘）。
• 认证方式选“Subversion authentication”。
• 端口默认443（HTTPS）或80（HTTP），如果冲突可以改成8443。
  安装完后会自动打开管理控制台。

2. 创建仓库和用户

1. 打开VisualSVN Server Manager。
2. 右键Repositories → Create New Repository。
3. 输入仓库名，比如“myproject”，选“Empty repository”或“Create default structure”。
4. 右键Users → Create User，设置用户名和密码。
5. 右键刚建的仓库 → Properties → Security，把用户加进去并给Read/Write权限。

3. 客户端连接本地服务器

仓库地址类似：https://你的电脑IP:8443/svn/myproject
或者本机用：https://localhost:8443/svn/myproject
然后用前面讲的Checkout方法检出即可。

局域网其他人想连的话，需要在Windows防火墙放行对应端口，并且确保大家在同一网段。

五、常见问题与避坑指南

1. 右键没有SVN菜单
   重启电脑。如果还没有，重新安装并勾选“Windows Shell Extension”。

2. 提交时报“Access denied”或认证失败
   检查用户名密码是否正确，或者服务器端权限是否给了Write。
   清除已保存认证：TortoiseSVN → Settings → Saved Data → Authentication Data → Clear。

3. 图标一直是红色感叹号
   右键 → TortoiseSVN → Clean up，勾选“Break locks”和“Fix timestamps”。

4. 命令行svn找不到
   把TortoiseSVN安装目录下的bin文件夹加入系统环境变量Path。
   方法：此电脑→属性→高级系统设置→环境变量→系统变量里的Path→编辑→新建，粘贴路径。

5. 大文件提交很慢
   在TortoiseSVN设置里把“Use sound”关掉，网络不好时优先用有线连接。
   服务器端可以把仓库放在SSD上。

6. 升级Windows后SVN打不开
   重新安装最新版TortoiseSVN即可，旧版本兼容性差。

六、进阶小技巧

• 忽略不需要版本控制的文件：右键文件夹 → TortoiseSVN → Properties → New → svn:ignore，把*.log、bin、obj等写进去。
• 导出干净代码（不含.svn隐藏目录）：右键 → TortoiseSVN → Export。
• 命令行批量操作示例：

  svn update
  svn status
  svn commit -m "批量提交说明"

• 想换Git的话，可以用git-svn桥接，但那是另一个话题了。

按照上面步骤做完，Windows上的Subversion就能正常用起来了。个人开发装客户端就够，小团队再加个VisualSVN Server，基本能覆盖90%的场景。操作过程中有任何报错，把完整错误信息记下来，对照第五节的常见问题基本都能解决。