Eclipse 手動安裝 Subversive SVN 插件全流程：離線部署與版本匹配避坑指南

為什麼選擇手動離線安裝？

• 企業內網無法訪問 Eclipse Marketplace。
• 精確控制插件版本，避免自動更新導致不兼容。
• 統一團隊開發環境，離線分發安裝包。

準備工作

1. JDK 配置：下載 JDK、配置 `JAVA_HOME`、`JRE_HOME`、`Path`。
2. Eclipse 下載：推薦 Eclipse IDE for Java EE Developers（Kepler SR2 或更新版本）。
3. 插件包下載：
   • Subversive 核心：`Subversive-3.0.4.I20160131-1700.zip`
   • SVN Connectors：`Subversive-connectors-5.0.0.I20150529-1700.zip`（注意：官方版本有 HTTP 415 Bug，需使用修正版或匹配版本）

目錄結構佈局

eclipse/
├── dropins/
│   ├── svn.link
│   └── svnconnectors.link
└── myPlugin/
    ├── svn/
    │   ├── features/
    │   └── plugins/
    └── svnconnectors/
        ├── features/
        └── plugins/

具體步驟

1. 在 `eclipse/myPlugin/` 下建立 `svn`、`svnconnectors` 兩個目錄。
2. 解壓兩個 ZIP，將各自的 `features/`、`plugins/` 目錄複製到對應目錄下。
3. 創建 Link 文件（Windows 用雙反斜杠，Linux/Mac 用正斜杠）：

   # eclipse/dropins/svn.link
   path=myPlugin\\svn
   
   # eclipse/dropins/svnconnectors.link
   path=myPlugin\\svnconnectors

4. 重啟 Eclipse（`-clean` 參數強制刷新）。

驗證安裝

• Welcome 頁面出現 SVN 圖標/入口。
• Help → About Eclipse → Installation Details → Plug-ins 列表中搜索 `Subversive`、`SVN Connectors` 確認版本號。

核心避坑：Connectors 版本必須與 Subversive 核心匹配

若 Import 項目報錯、連接失敗、HTTP 415（Unsupported Media Type），多半是 Connectors 版本不匹配或官方包 Bug。解決方案：

1. 嘗試不同版本的 Connectors（如 4.x、3.x、6.x）直至匹配成功。
2. 參考社區修正版（修改源碼將 POST 改為 GET）：修復指南。
3. 或改用 Subclipse（另一款 SVN 插件，安裝相對簡單）。

總結

Link 文件機制是 Eclipse 擴展點的優雅實現，實現插件隔離、版本鎖定、離線分發。掌握此技能，應對內網、離線、版本凍結等場景遊刃有餘。