摘要： 本文将带你从零开始掌握 SVN 版本控制系统，结合 TortoiseSVN 图形客户端工具，深入学习包括安装、检出、提交、更新、回滚、冲突解决等常用开发操作，快速上手团队协作！

---

🧩 什么是 SVN？

SVN（Subversion）是一种经典的集中式版本控制系统，广泛用于团队代码管理、文档版本记录等。

• ✅ 集中管理代码版本
• ✅ 多人协作开发利器
• ✅ 适用于局域网/内网项目
• ✅ 搭配 TortoiseSVN 提供图形操作界面

---

🧱 第一步：安装 SVN 客户端（Setup-Subversion-1.8.17）

🧰 工具下载：

工具名	说明	下载地址
Setup-Subversion-1.8.17	SVN命令行客户端	Subversion 1.8.17 Setup
TortoiseSVN	SVN图形界面客户端	TortoiseSVN

📦 安装步骤：

1. 解压 Apache-Subversion-1.8.17.zip
2. 双击 Setup-Subversion-1.8.17.msi 安装
3. 安装完成后，可在命令行输入 svn --version 验证是否安装成功

---

🎨 第二步：安装 TortoiseSVN 图形客户端

💾 安装 TortoiseSVN：

• 下载匹配系统位数的版本（32位或64位）
• 双击安装，默认选项安装即可
• 安装后右键菜单中会出现 SVN Checkout、SVN Update 等选项

---

📁 第三步：检出（Checkout）项目代码

将远程仓库代码拉取到本地：

# 示例仓库地址
https://svn.example.com/repos/YourProject

🧭 操作步骤：

1. 在任意目录空白处右键 → SVN Checkout
2. 填写：
   • URL of repository：仓库地址
   • Checkout directory：代码保存到哪里
3. 点击 “OK”，输入账号密码
4. 拉取成功后，文件夹图标为 ✅ 绿色打勾

💡 建议：检出时选择 trunk 或指定版本分支路径，避免检出整个仓库

---

🔄 第四步：更新（Update）本地代码

保证你的代码为最新版本，防止提交冲突。

操作方式：

• 在项目根目录空白处右键 → SVN Update
• 稍等片刻，查看更新日志
• 图标重新变为绿色 ✅

⚠️ 每次开发前必须更新代码

---

💾 第五步：提交（Commit）本地修改

将你的更改同步到远程仓库：

1. 修改完代码后，图标会变为红色 ❗️

2. 右键 → SVN Commit

3. 勾选修改的文件（注意是否包含未 add 的新文件）

4. 填写有意义的注释（例如：

   [新增] 登录页面样式
   [修复] 用户信息接口超时问题
   

5. 点击 “OK” 提交

---

⏪ 第六步：回滚修改（Revert）

撤销本地未提交的修改：

🌟 操作方式：

• 对单个文件：右键该文件 → TortoiseSVN → Revert
• 对整个目录：在根目录右键 → TortoiseSVN → Revert

⚠️ 回滚不可恢复，需谨慎操作！

---

🕵️ 第七步：查看日志与版本回退

查看某个文件/项目的修改历史，支持恢复到任意历史版本。

查看历史：

1. 右键 → TortoiseSVN → Show Log
2. 查看版本号、作者、提交信息、文件修改记录
3. 可选择 Compare with previous 进行差异对比

回退操作：

• 临时查看：Update to revision
• 恢复整个目录：右键某版本 → Revert to this revision

---

🔀 第八步：冲突（Conflict）解决指南

❌ 什么时候出现冲突？

• 你修改了文件同时别人也修改并提交了 → 你更新时会冲突

✅ 如何解决？

1. 冲突文件将出现 4 个版本：
   • main.cs
   • main.cs.mine
   • main.cs.r123
   • main.cs.r124
2. 打开对比工具或用 VS Code 进行合并
3. 手动整合为正确版本
4. 右键文件 → Resolved
5. 再次提交

---

🛠️ 实用补充功能

功能	用法	说明
忽略文件夹	Add to ignore list	如 bin/obj/.idea
新建文件	SVN Add → Commit	文件新增需要手动 Add
删除文件	Delete → Commit	本地删除后需要同步到远程
快速对比	Diff	对比改动内容
查看状态图标	右键 → Check for modifications	查看哪些文件被修改/未添加

---

✅ SVN 使用建议（Best Practice）

📌 每次开发前都要 Update
📌 每次提交写清楚注释说明
📌 不要提交调试文件、编译中间文件
📌 保持目录结构清晰
📌 定期清理不再使用的分支或标签
📌 提交前先检查是否包含未添加的文件

---

📌 总结

通过本文，你应该已经掌握了使用 TortoiseSVN + SVN 的日常开发流程：

• ✅ 安装配置
• ✅ 检出项目
• ✅ 更新代码
• ✅ 提交改动
• ✅ 回滚与历史查看
• ✅ 冲突解决

🔧 不论是个人项目还是团队协作，合理使用 SVN 都能大幅提升版本管理效率。