Eclipse/MyEclipse 集成 VSS (Visual SourceSafe) 插件完整安裝與使用指南

環境準備

• Eclipse 3.3 / MyEclipse 6.0
• VSS 客戶端已安裝（插件依賴本地 ssapi.dll 等 COM 組件）
• 插件下載：SourceForge vssplugin（最新 org.vssplugin_1.6.2，約 1MB）

安裝步驟

1. 解壓下載的 .rar，得到文件夾 org.vssplugin_1.6.2。
2. 將整個文件夾複製到 Eclipse 安裝目錄下的 plugins/ 目錄（MyEclipse 為 MyEclipse/eclipse/plugins/）。
3. 啟動 Eclipse，選單 Help → About Eclipse SDK → Plug-in Details，檢查列表中是否出現 org.vssplugin_1.6.2。
   • 若未顯示：關閉 Eclipse，刪除 configuration/ 目錄下除 config.ini 外的所有文件/文件夾，重新啟動（清除緩存）。

項目接入 VSS（Share Project）

1. 包資源管理器右鍵項目 → Team → Share Project。
2. 選擇 VSS Configuration Wizard → Next。
3. 填寫連接參數：
   • Username / Password：VSS 賬號密碼。
   • VSS Directory：VSS 服務器上 srcsafe.ini 所在目錄（可瀏覽選擇網絡路徑）。
   • Source Dir：要共享的項目路徑，通常用默認 / 表示整個項目。
   • Relative Mount Point：VSS 資料庫中與本地項目對應的相對路徑。例如 VSS 中項目在 $/MyProject，則填 $/MyProject。
4. 若提示 Unable to find any VSS installation，說明本機未安裝 VSS 客戶端，需先安裝（完整安裝包約 200MB）。

日常操作

• Checkout：右鍵文件/目錄 → Team → Checkout。文件名前顯示鉤子，後顯示鎖定用戶名。
• Checkin：右鍵 → Team → Check In，輸入註釋提交。
• Undo Checkout：放棄鎖定，恢復原版本。
• Get Latest Version：同步服務器最新代碼。
• History：查看版本歷史、差異對比。
• Add to VSS：新建文件後右鍵 → Team → Add to VSS 納入版控。

常見問題與修復

1. 圖標裝飾器不顯示（Checkout 狀態不刷新）

現象：初次共享顯示用戶名，關閉 Eclipse 重開後消失。
解決：Window → Preferences → General → Appearance → Label Decorations，勾選 VSS Plugin Team Decorator（列表最後一項）。

2. 狀態不同步

插件不會自動輪詢服務器狀態。手動刷新：右鍵項目/文件夾 → Team → Update State。

3. 網絡路徑映射

VSS Directory 必須使用 UNC 路徑（\\Server\VSS），不能用映射盤符（Z:\），因為 Eclipse 進程可能無該盤符映射。

遷移建議

VSS 已停止維護（微軟 2005 年後無更新），存在數據庫損壞風險、無原子提交、分支合併極弱等缺陷。強烈建議新項目直接使用 Git / SVN（Subversive/Subclipse 插件），舊項目制定遷移計劃（vss2git、vss2svn 工具可保留歷史）。