Visual SourceSafe (VSS) 是微軟早期版控系統，雖已老舊但仍有維護專案在使用。本文記錄 VSS 伺服器/用戶端安裝、資料庫建立、Eclipse VSS Plugin 設定、專案加入版控、既有專案簽出全流程。
VSS 伺服器端安裝與設定
- 安裝 VSS 6.0d 於伺服器
- 共享安裝目錄下的
NETSETUP.EXE（通常在 C:\Program Files\Microsoft Visual Studio\Common\VSS），供用戶端網路安裝
- 建立原始碼控制資料庫：
- 建立共享資料夾（如
\\server\test）
- 啟動 Visual SourceSafe Administrator
- Tools → Create Database，指向共享資料夾
- 新增使用者帳號（開發團隊成員）
用戶端安裝
- 從伺服器共享目錄執行
NETSETUP.EXE 安裝 VSS 用戶端
Eclipse VSS Plugin 安裝
- 下載
org.vssplugin_1.4.1-2.0-compability.zip（SourceForge：sourceforge.net/projects/vssplugin）
- 解壓縮，將
org.vssplugin_1.4.1 資料夾複製至 ECLIPSE_HOME/plugins/
- 重新啟動 Eclipse（若不見，刪除
configuration/ 除 .ini 外所有檔案）
- Help → About → Plug-in Details 確認載入成功
- Window → Customize Perspective → Show View / Other 勾選 VSS 相關選項
專案加入版控（新專案）
- 本地建立專案工作目錄，複製至伺服器對應位置
- Eclipse → File → New → Project 選擇伺服器上專案路徑建立專案
- 專案右鍵 → Team → Share Project → 選 VSS Configuration Wizard
- 輸入用戶名/密碼
- Browse 選擇 VSS 資料庫目錄（含
srcsafe.ini 的資料夾）
- VSS 用戶端建立對應子專案資料夾
- Relative mountpoint 選擇該資料夾
- 勾選「Add project recursively」，Finish
- 專案右鍵 → Team → Add to VSS，輸入註解
- 即可執行 Check-in / Check-out
簽出既有專案（客戶端）
- Eclipse → File → New → Project
- 專案右鍵 → Team → Share Project → VSS Configuration Wizard
- 輸入帳號密碼、選擇資料庫目錄
- Relative mountpoint 選擇 VSS 中對應專案資料夾
- 勾選遞迴，Finish
- 專案右鍵 → Team → Refresh 同步最新版本
電腦重啟後重新開啟專案
- 確認本機可免密碼存取伺服器共享
- Eclipse 專案右鍵 → Open Project
- 專案右鍵 → Team → Share Project（重新連結）
常見問題排查
- Plugin 不顯示：清理
configuration/ 目錄重啟
- 無法連線資料庫：檢查網路共享權限、
srcsafe.ini 路徑正確性
- Check-out 失敗：確認 VSS 用戶端離線模式設定、檔案未被他人獨佔
- 編碼問題：VSS 6.0d 對中文檔名支援有限，建議路徑/檔名使用英文
遷移建議
VSS 已停止維護，已知問題：資料庫易損毀、無原子提交、分支合併弱、效能差。強烈建議遷移至 Git/SVN/TFS。Eclipse 原生支援 Git (EGit) 與 SVN (Subversive/Subclipse)，遷移工具如 vss2svn、git-vss 可保留歷史紀錄。
