Eclipse 安裝 SVN 插件與 TortoiseSVN 客戶端完整指南

Eclipse 安裝 SVN 插件與 TortoiseSVN 客戶端完整指南

版本控制是團隊協作基礎。本文介紹 Eclipse 中 Subversive/Subclipse 兩大 SVN 插件的在線/離線安裝，以及 Windows 下 TortoiseSVN 圖形化客戶端的安裝與命令行工具啟用。

一、Eclipse SVN 插件安裝

方式 1：在線安裝（推薦）

1. Help → Eclipse Marketplace
2. 搜索 SVN，首項通常為 Subclipse（或 Subversive）。
3. 點擊 Install，下一頁建議全選所有子功能（SVN Kit、Connectors、Ignore Patterns 等），避免缺少連接器導致無法連接倉庫。
4. 接受許可、重啟 Eclipse。
5. 驗證：Window → Show View → Other → SVN → SVN Repositories。

方式 2：離線安裝

1. 下載離線包（如 subclipse-4.2.4.zip），解壓得到 features、plugins 兩目錄。
2. 在 Eclipse 安裝目錄下創建 myPlugins/svn，將上述兩目錄複製進去。
3. 進入 dropins 目錄，創建 svn.link 文件，內容：

path=C:/tools/developer/eclipse-mars/eclipse/myPlugins/svn

（Windows 路徑用雙反斜杠或正斜杠）

4. 重啟 Eclipse，插件自動加載。

優缺點：離線安裝適合無網絡環境，但升級維護麻煩；在線安裝自動解決依賴、版本兼容。

二、TortoiseSVN 安裝（Windows）

1. 下載 TortoiseSVN-1.x.x.xxxxx-64bit.msi（官網 tortoisesvn.net）。
2. 雙擊安裝，關鍵步驟：Command Line Client Tools → Will be installed on local hard drive（默認未勾選，必須手動選中），以在 CMD/PowerShell 中使用 svn 命令。
3. 完成安裻，資源管理器右鍵菜單出現 TortoiseSVN 選項。
4. 設置圖標覆蓋：Settings → Icon Overlays → Drive Types 勾選固定/可移動/網絡盤，避免圖標不顯示。
5. 配置 Diff/Merge 工具：Settings → External Programs 可指定 Beyond Compare、KDiff3、VS Code 等。

三、常用操作速查

四、最佳實踐建議

• 統一客戶端：團隊約定使用同一 SVN 客戶端版本，避免工作副本格式不兼容（svn upgrade）。
• 忽略文件：全局 global-ignores（*.class, target/, .settings/, bin/, *.log）+ 項目級 svn:ignore。
• 提交規範：強制日志格式（如 [JIRA-123] feat: add login），配合 Pre-commit Hook 檢查。
• 分支策略：Trunk 主線穩定，Feature Branch 開發，Release Branch 准發布，Hotfix Branch 緊急修復。
• 定期清理：svn cleanup 解決僵尸鎖，svn cleanup --remove-unversioned --remove-ignored 清理垃圾文件。

五、遷移提示

新項目強烈建議使用 Git（分布式、分支廉價、生態豐富）。SVN 到 Git 遷移可用 svn2git、SubGit、GitLab/GitHub 導入工具，保留完整歷史。

掌握 Eclipse 插件與 TortoiseSVN 雙模式，適應不同開發場景（IDE 內快速操作 vs 文件系統級精細控制）。