Eclipse 下 Subclipse 實現 Subversion 源碼管理完整指南

為什麼選擇 Subversion + Subclipse？

CVS 雖然普及但缺陷明顯：二進制文件處理差 (全量存儲)、不支持文件/目錄移動重命名 (丟失歷史)、無原子提交 (部分提交導致庫不一致)。Subversion 從根本解決這些問題：

• 原子提交：全成功或全失敗，庫永遠一致
• 高效二進制存儲：差分算法優化網絡/磁盤
• 真正的移動/重命名：保留完整歷史
• 目錄版本化：每次修訂是完整目錄樹快照，Tag/Branch 近乎零成本
• 多協議訪問：HTTP/HTTPS (WebDAV)、svn://、file:// 靈活部署

Subclipse 將 Subversion 无缝集成到 Eclipse IDE，提供圖形化操作界面，消除命令行切換成本。

Subclipse 安裝與配置

1. 安裝插件

1. Help → Software Updates → Find and Install
2. 選 Search for new features to install → Next
3. New Remote Site：Name=Subclipse, URL=https://subclipse.tigris.org/update_1.0.x
4. 勾選 Subclipse 完成安裝，重啟 Eclipse

2. 定義倉庫位置

1. 打開視圖：Window → Show View → Other → SVN Repository
2. 右鍵 New → Repository Location
3. 輸入 URL (如 https://svn.example.com/repo/project 或 svn://server/repo)，Finish

3. 檢出項目

在 SVN Repository 視圖右鍵項目 → Checkout，兩種模式：

• Check out as Project configured by New Project Wizard (推薦)：走 Eclipse 新建項目向導，自動識別 Java/Web 等項目類型，應用標準模板
• Check out as Project in Workspace：簡單創建通用項目，需手動配置構建路徑

注意：檢出後必須手動刷新/配置 Java Build Path (源碼目錄、庫依賴)。

4. 將本地新項目導入倉庫

1. Package Explorer 右鍵項目 → Team → Share Project
2. 選擇/創建倉庫位置，指定項目名
3. 勾選需版本控制的文件/目錄 (排除 bin/、.classpath、.project、生成文件、臨時文件)
4. 輸入初始提交註釋，Finish

日常開發工作流

文件狀態可視化 (Package Explorer)

• 黃桶圖標：已受版本控制
• 星號 *：本地修改未提交
• 問號 ?：未加入版本控制
• 紅色 > 圖標：衝突狀態

核心操作 (Team 菜單)

屬性管理 (Subversion 亮點)

右鍵文件/目錄 → Team → Set Property，內置實用屬性：

• svn:executable：設置可執行位 (Unix/Linux)
• svn:needs-lock：強制獨佔鎖 (二進制文件必備)。加鎖後文件只讀，需 Team → Get Lock 編輯，Release Lock 或 Commit 釋放
• svn:mime-type：指定 MIME 類型，影響 diff/merge 行為
• svn:ignore：目錄層級忽略模式 (如 *.class、target/)
• svn:keywords：關鍵字展開 ($Id$、$Rev$ 等)
• svn:externals：外部定義，引入其他倉庫路徑

Tag 與 Branch 管理

Team → Branch/Tag 對話框：

• 來源：工作副本或特定修訂版
• 目標：倉庫路徑 (通常 /tags/Release_1.0 或 /branches/feature-xyz)
• 選項：Switch working copy to new branch/tag (創建後自動切換)

Subversion 以「廉價複製」實現：Tag/Branch 僅記錄源修訂的指針，幾乎零空間零時間。切換分支：Team → Switch，僅更新差異文件。

修訂歷史與對比

• Team → Show in Resource History：查看文件/目錄/項目完整歷史
• 列表顯示：修訂號、作者、日期、日誌、變更文件列表
• 雙擊修訂：打開對比編輯器 (與前一版/當前工作副本)
• 右鍵修訂：Revert changes from this revision (反向合併撤銷)

進階技巧與最佳實踐

1. 忽略模式標準化

項目根目錄設置 svn:ignore：

*.class
*.log
target/
bin/
.settings/
.project
.classpath
*.tmp
*.bak

全團隊共享，避免垃圾文件入庫。

2. 提交日誌規範

[模塊] 簡短摘要 (關聯Issue號)
- 詳細變更點1
- 詳細變更點2

示例：[UserService] 修復登錄失敗問題 (#1234) - 修正密碼加密邏輯 - 增加單元測試覆蓋

3. 分支策略

• Trunk：主線開發，保持穩定可發布
• Feature Branches：大功能/重構隔離開發，完成合併回 Trunk 後刪除
• Release Branches：發布準備期分出，僅修 Bug，發布後打 Tag (Release_1.0.0)，合併修復回 Trunk
• Hotfix Branches：線上緊急修復，從 Tag 分出，修復後合併到 Trunk 和 Release Branch

4. 衝突解決流程

1. Synchronize 發現衝突 (紅雙箭頭圖標)
2. 雙擊打開三方對比編輯器 (Base / Theirs / Yours)
3. 手動合併或選擇 Use Theirs/Use Yours
4. 保存，右鍵 Mark as Merged
5. Commit 合併結果

5. 鎖機制用於二進制資源

對圖片、文檔、編譯產物等不可合併文件，強制 svn:needs-lock，避免雙方同時修改產生無法合併的衝突。

總結

Subclipse 將 Subversion 的強大功能原生注入 Eclipse：

1. 圖形化操作降低學習曲線，日常 95% 操作無需命令行
2. 雙向同步視圖 + 可視化衝突解決 = 高效團隊協作
3. Tag/Branch 廉僷複製鼓勵正確分支策略
4. 屬性系統 (鎖/忽略/關鍵字/外部) 解決工程化細節
5. 歷史追溯 + 反向合併 = 安全的變更控制

配合規範的忽略模式、日誌格式、分支策略，Subclipse + Subversion 成為 Eclipse 團隊開發的標準源碼管理方案。