Eclipse 3.4 Ganymede 安裝 Subclipse 與 Subversive 完整避坑指南

Eclipse 3.4 Ganymede 引入全新 p2 Provisioning 平台，插件安裝機制大幅變更，導致舊版 Subclipse 安裝頻繁失效。本文記錄實測可行的安裝方案與核心變更解析。

現象複現：Link 方式安裝的玄學失效

• 同一套 Eclipse + Subclipse 1.4.3，家裡機器 Link 方式正常，公司筆記本失效
• 懷疑下載檔案損壞，從家裡複製安裝目錄到公司 → 正常
• 回家重裝 Eclipse 3.4 → 同樣失效（試過 1.4.3/1.2.6/1.0.6 全部失效）
• 公司機器未動過配置，打開依然正常

根因：Ganymede 新增 dropins 目錄掃描機制、p2 元數據嚴格校驗、安裝管理器強制聯網解析依賴，Link 方式不再可靠。

方案一：p2 更新站點在線安裝 Subclipse 1.4.x（推薦）

1. Help → Software Updates → Available Software → Add Site
2. 輸入：https://subclipse.tigris.org/update_1.4.x
3. 勾選 Subclipse + SVN Kit Adapter（純 Java，無需本地客戶端）
4. 完成安裝重啟，Window → Preferences → Team → SVN 確認 SVN Interface 為 SVNKit

離線安裝技巧：更新站點頁面右鍵「Download」下載完整站點壓縮包 → 本地指向壓縮包安裝（安裝過程仍會嘗試聯網下載微小元數據檔）。

方案二：安裝 Subversive（原生 Eclipse 專案，支援 SVN 1.5+）

Subversive 採用雙站點架構：核心框架 + 連接器分離。

步驟 1：安裝 Subversive 核心

• 更新站點：https://download.eclipse.org/technology/subversive/0.7/update-site/
• 安裝 Subversive SVN Team Provider（含 UI、核心 API）

步驟 2：安裝連接器

• 更新站點：https://www.polarion.org/projects/subversive/download/eclipse/2.0/update-site/
• 勾選 SVNKit 1.8.x（推薦，純 Java、跨平台、支援 SVN 1.5~1.14）
• 或選 JavaHL (JNI)（需本地 Subversion 二進制，效能略優但部署複雜）

版本相容性陷阱

Subclipse vs Subversive 選型建議

Ganymede 插件安裝新機制速查

• dropins/：掃描目錄，適合簡單插件（無依賴、無 p2 元數據）
• links/：舊版相容，**不再推薦**，元數據驗證嚴格易失效
• p2 更新站點（在線/本地）：標準方式，完整依賴解析、版本衝突檢測、回滾支援
• 目錄結構：plugins/、features/、p2/org.eclipse.equinox.p2.engine/profileRegistry/ 存放安裝歷史

常見問題排查

1. 安裝後無 SVN 選單：Window → Preferences → Team → SVN 檢查 Interface 是否選中 SVNKit
2. JavaHL 載入失敗：java.library.path 包含 libsvnjavahl-1.dll/so 目錄，或改用 SVNKit
3. Proxy 環境無法連線更新站點：Window → Preferences → General → Network Connections 設定 Proxy，或下載離線站點壓縮包
4. 工作區遷移後 SVN 資訊丟失：.metadata/.plugins/org.eclipse.core.runtime/.settings/org.eclipse.team.svn.core.prefs 確認 svnkit.useJNA=true

Eclipse 3.4 雖引入 p2 造成短期適應痛楚，但長遠奠定了模組化、版本化、可回滾的插件管理基石。掌握 p2 工作原理，比記住具體 URL 更有價值。