Eclipse 整合 VSS (Visual SourceSafe) 插件配置與操作全流程

雖然 VSS 已被微軟停止維護，但存量項目仍需在 Eclipse 中對接。本文基於開源插件 org.vssplugin (SourceForge)，記錄安裝、新建/打開項目綁定、日常操作、重啟恢復的標準化步驟。

一、 插件獲取與安裝

1. 下載：org.vssplugin_1.6.1.zip (最新版 1.6.1)
2. 解壓，獲得 org.vssplugin_1.6.1 文件夾。
3. 複製到 ECLIPSE_HOME/plugins/ 目錄下。
4. 重啟 Eclipse。
5. 驗證：Help → About Eclipse → Plug-in Details 列表中出現 org.vssplugin。
6. 啟用視圖：Window → Customize Perspective → Other 勾選 VSS 相關項 (如 VSS Repository 視圖)。

二、 新建項目並加入 VSS 版本控制

1. 本地準備好源碼目錄 (如 D:/workspace/MyProject)。
2. Eclipse: File → New → Project... 選 Java Project (或對應類型)，取消勾選 Use default location，Browse 選中上述源碼目錄 → Finish。
3. 專案右鍵 → Team → Share Project...
4. 選 VSS Configuration Wizard → Next。
5. 輸入 VSS 用戶名/密碼。
6. VSS Database：Browse 選中服務器端 srcsafe.ini 所在目錄 (需本機已映射網絡盤或 UNC 路徑可直接訪問，且無需密碼自動登錄)。
7. 打開 VSS 客戶端 (或 Eclipse VSS Repository 視圖)，在專案根節點下創建與項目同名的文件夾 (如 $/MyProject)。
8. Wizard 中 Relative mountpoint 選擇剛建的文件夾 → Next。
9. 勾選 Add project to VSS after finish (底部多選框) → Finish。
10. 彈出註釋框，輸入初始版本說明 (如 "Initial commit") → OK。
11. 完成：項目圖標出現版本控制標識，Team 菜單可用 Check-in / Check-out / History / Revert 等操作。

三、 打開已有 VSS 控制的項目

1. File → New → Project... 同樣指向本地工作目錄 (或先從 VSS Get Latest 到本地)。
2. 專案右鍵 → Team → Share Project... → 選 VSS Configuration Wizard。
3. 輸入用戶名/密碼、選擇 VSS Database 目錄。
4. Relative mountpoint 選擇對應的 VSS 服務器路徑 (如 $/MyProject)。
5. 勾選 Add project to VSS after finish → Finish。
6. 專案右鍵 → Team → Refresh 同步狀態圖標。

四、 Eclipse 重啟後恢復 VSS 連接

1. 確保本機能免密碼訪問 VSS 服務器共享 (網絡鄰居預先登錄/映射磁盤)。
2. 啟動 Eclipse，專案若關閉：右鍵 → Open Project。
3. 專案右鍵 → Team → Share Project... (向導會復用工作區元數據自動匹配，通常直接 Finish)。
4. 如提示綁定信息丟失，按「打開已有項目」步驟重新綁定。

五、 日常核心操作速查

六、 常見問題與規避

• Database 路徑無法 Browse：確保本機已映射 VSS 服務器共享盤符，或輸入 UNC 路徑 \\server\vss\。
• 權限錯誤/只讀：VSS 用戶需具備項目 Read/Write/Delete 權限 (VSS Admin 設置)。
• 大文件/二進制文件：VSS 對二進制差異存儲弱，建議大資源走外部存儲 (如文件服務器/Artifactory)，庫中只存引用。
• 並發衝突：VSS 採用悲觀鎖 (Check-out 獨占)，團隊協作需溝通避免長期佔用。
• 插件版本兼容：Eclipse 4.x (Neon 及以上) 可能需插件 1.6.1+，舊版插件可能報 ClassNotFoundException。

七、 遷移建議

VSS 存在單點故障、無原子提交、分支合併極弱、數據庫易損壞等架構缺陷。條件允許時，強烈建議遷移至 Git (GitLab/GitHub/Gitea) 或 SVN：

1. 用 vss2git / vss2svn 工具保留歷史遷移。
2. Eclipse 原生 EGit / Subversive 完美替代 VSS 插件。
3. 建立 .gitignore / svn:ignore 替代 VSS 忽略機制。

本文為存量維護提供操作手冊，新項目請直接選擇現代版控系統。

1. 上一篇文章： Eclipse 中使用 Ant 執行 JUnit 單元測試完整教程
2. 下一篇文章： J2ME MIDP 2.0 與 WAP 實現手機撥號功能對比

Java 相關知識

Algorithms 4th Edition：StdLib 輸入輸出庫完整使用指南

Princeton Algorithms 4th Editi

Eclipse RCP 客戶端多執行緒開發實戰指南

Eclipse Rich Client Platform (

NetBeans Visual Web JSF 開發：數據綁定組件訪問數據庫完整教程

NetBeans Visual Web JSF 框架提供拖拽

Java 流程控制語句完全指南：if/switch/while/for/break/continue/多重循環

流程控制是程序邏輯的骨架。本文系統講解 Java 中條件語句