Eclipse 整合 SVN 版本控制需安裝 Subclipse 插件，**版本必須與 Eclipse 版本對應**，否則會出現相容性錯誤、功能缺失。

安裝步驟

1. 開啟 Eclipse → Help → Install New Software...
2. 點擊 Add... 增加更新站點：
   Name: Subclipse 1.6.x (Eclipse 3.2+)
   Location: https://subclipse.tigris.org/update_1.6.x
3. 勾選 Select All 全選所有元件 → Next。
4. 確認授權協議 → 選擇 I accept the terms... → Finish 開始安裝。
5. 安裝完成後**必須重啟 Eclipse**。

驗證安裝成功

重啟後：Window → Preferences → 左側類別展開 Team → 若出現 SVN 選項即代表安裝成功。

版本對應速查表（關鍵）

Eclipse 版本	推薦 Subclipse 更新站點
Eclipse 4.2x (Juno) ~ 4.7x (Oxygen)	https://subclipse.tigris.org/update_1.10.x (Subclipse 1.10.x)
Eclipse 4.8 (Photon) ~ 4.12 (2019-06)	https://subclipse.tigris.org/update_1.12.x (Subclipse 1.12.x)
Eclipse 4.13 (2019-09) ~ 最新	https://subclipse.tigris.org/update_1.14.x (Subclipse 1.14.x)

原則： 選擇與 Eclipse 主版本相容的最新 Subclipse 版本，**切勿安裝過高版本**（如 Eclipse 4.6 裝 1.14.x 會報缺少相依套件）。

常見問題

• 安裝極慢/卡住： 國內連 Tigris.org 慢，可改用鏡像站或離線安裝（下載 site.xml 與所有 .jar 至本地資料夾，指向本地路徑安裝）。
• 缺少 JavaHL/JNA 庫： 安裝後首次使用 SVN 會提示，請依提示安裝對應原生庫（Windows 通常自動安裝 JNA，Linux 需 apt install libsvn-java）。
• 專案右鍵無 Team 選單： 確認專案已啟用 Team 支援，或手動 Team → Share Project → SVN。