摘要： 本文將帶你從零開始掌握 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 都能大幅提升版本管理效率。