前置準備
- Eclipse / MyEclipse 安裝目錄
- Subclipse 插件離線包（
subclipse-*.zip）或聯網訪問 Eclipse Marketplace
- SVN 服務器地址、用戶名、密碼
步驟 1：安裝 Subclipse 插件
- 離線安裝（推薦企業內網）：
- 將解壓後的
features、plugins 文件夾複製到 Eclipse 安裝目錄下的 dropins 文件夾。
- 重啟 Eclipse，彈出「Report usage of Subclipse to Subclipse team」提示，點擊 OK。
- 在線安裝：
- Help → Eclipse Marketplace → 搜索 Subclipse → Install → 重啟。
步驟 2：打開 SVN 視圖
- 菜單 Window → Show View → Other...
- 輸入 SVN 過濾，選中 SVN Repository Exploring → Open。
- 視圖區出現 SVN Repositories 面板。
步驟 3：添加倉庫地址
- 在 SVN Repositories 空白處右鍵 → New → Repository Location。
- 輸入 SVN URL（如
https://svn.example.com/svn/myproject），點擊 Next。
- 輸入用戶名/密碼，勾選 Save password，Finish。
- 倉庫樹展開，定位到具體項目目錄（通常為
trunk、branches/xxx 或 tags/x.x.x）。
步驟 4：檢出項目到工作空間
- 右鍵項目目錄 → Check Out...
- 彈出向導：
- Check out as a project in the workspace（推薦）
- Project name 自動填充，可修改。
- Depth 保持 Fully recursive（完整遞歸）。
- Revision 選 HEAD (latest)。
- 點擊 Finish，進度條顯示下載文件數量與大小，視項目體積耗時數秒至數分鐘。
步驟 5：轉換為 Maven/Gradle 項目（如適用）
- 項目右鍵 → Configure → Convert to Maven Project（或 Gradle）。
- 等待依賴下載，若
pom.xml 紅叉，右鍵 → Maven → Update Project → 強制更新快照/發布版。
常見問題排查
| 現象 | 原因 | 解決 |
|---|
| 提示 "SVN connector not found" | 缺少 SVN Kit / JavaHL 連接器 | Window → Preferences → Team → SVN → SVN Connector → 選擇 SVNKit (Pure Java) → OK |
| 檢出後項目無源碼目錄標識 | 未識別為 Java 項目 | 項目右鍵 → Properties → Project Facets → 勾選 Java → Apply |
| 圖標顯示問號/衝突標記 | 本地有未提交修改或衝突 | 右鍵 → Team → Update to HEAD / Resolve Conflict |
| 密碼修改後無法更新 | 緩存舊憑證 | Windows: 刪除 %APPDATA%\Subversion\auth；Linux/Mac: ~/.subversion/auth |
進階技巧
- 忽略文件配置：項目右鍵 → Team → Add to svn:ignore → 輸入
target、.classpath、.settings、*.log 等模式。
- 分支/標籤操作：右鍵項目 → Team → Branch/Tag... → 指定遠程路徑（如
branches/feature-x） → 勾選 Switch to new branch 即時切換。
- 提交前掃描：安裝 Checkstyle / SpotBugs 插件，配置 Pre-commit Hook（需服務器支持）或本地 Git-SVN 工作流。
總結
Subclipse + Eclipse/MyEclipse 仍是許多存量項目維護 SVN 的主流組合。掌握「安裝插件 → 配置倉庫 → 檢出項目 → 轉換構建」標準流程，並熟悉連接器切換、忽略規則、分支管理等進階操作，即可高效應對日常版本控制需求。新項目建議遷移至 Git，但遺留系統穩定運行時，SVN 依然可靠。
