VSS 與 JBuilder 5/6 整合實戰：從安裝配置到團隊協作的完整指南

背景：經典 IDE 與版本控制的黃金搭檔

在 Git 尚未統治版本控制的年代（2000s 早期），Borland JBuilder 作為 Java 開發旗艦 IDE，配合 Microsoft Visual SourceSafe (VSS) 為無數國內項目提供了「集中式」版本管理方案。雖然技術棧已老舊，但其整合架構設計思想——IDE 無感知 VCS 操作、統一工作流抽象——對理解現代 IDE 插件機制仍有參考價值。本文復盤完整配置流程，兼作技術考古與遺留系統維護參考。

一、VSS 服務端部署與初始化

1. 乾淨安裝關鍵步驟

VSS 6.0 安裝前必須清理注冊表殘留，否則易發生「資料庫鎖定」、「用戶列表異常」等疑難雜癥：

# 1. 運行 regedit.exe
# 2. 刪除 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SourceSafe 全鍵
# 3. 以管理員身份運行安裝程序，選擇「服務器安裝」

2. 創建數據庫

1. 啟動 Visual SourceSafe 6.0 Admin，以 Admin 登錄（默認無密碼）。
2. 菜單 Tools → Create Database，選擇存放路徑（建議專用磁盤，NTFS 權限隔離）。
3. 生成 srcsafe.ini 等核心配置文件，此目錄即為「數據庫根目錄」。

二、JBuilder 專案接入 VSS

1. 綁定 VCS 提供者

JBuilder 菜單：Team → Select Project VCS → 選擇 "Visual SourceSafe"

2. 專案入庫

1. Team → Place Project into VSS
2. 填寫數據庫路徑（srcsafe.ini 所在目錄，如 \\server\vss\project1）
3. Admin 用戶名/密碼
4. 連續兩次 Next → Finish

此過程將本地專案文件遞歸添加至 VSS，並在本地生成 vssver2.scc 等綁定標記文件。

三、用戶權限體系構建

1. 創建開發賬號

VSS Admin → Users → Add User，按真實姓名/拼音命名，設置初始密碼。

2. 啟用專案級安全

Tools → Options → Project Security → 勾選 Enable Project Security。此舉將權限粒度從「整個數據庫」細化到「專案/目錄」。

3. 分配權限矩陣

Tools → Rights by Project，典型角色配置：

4. 文件系統權限配合（關鍵）

VSS 數據庫文件存放於網絡共享，必須在 **Windows 資源管理器 → 共享目錄 → 安全** 設置對應用戶組的 **讀/寫/修改** 權限。缺少此步將導致「Access Denied」假性 VSS 錯誤。

四、開發人員日常工作流

1. 獲取專案（首次/新機器）

兩種途徑：

• 途徑 A： Team → Pull Project from VSS
• 途徑 B： File → New → Project → Pull Project from VSS

步驟：映射網絡共享 → 選擇數據庫 → 輸入個人賬號 → 選擇專案 → 指定**空**本地目錄 → Finish。

2. 同步最新代碼

Team → Commit Browser → 查看變更列表 → 勾選需更新文件 → Commit (此處 Commit 實為 Update/同步)。JBuilder 6 支持對單個變更選擇 Action（合併/覆蓋/忽略）。

3. 編輯流程：Check Out → Modify → Check In

# 操作：右鍵文件 → Visual SourceSafe → Check Out "FileName.java"
# 修改代碼...
# 操作：右鍵文件 → Visual SourceSafe → Check In "FileName.java" → 輸入註釋

鐵律： 未 Check Out 不可編輯；編輯完成必須 Check In，否則文件長期鎖定阻塞他人。

4. 添加/刪除文件

• 添加： 右鍵新文件 → Visual SourceSafe → Add "NewFile.java"
• 刪除： 1) Check Out 目標文件 2) 右鍵 → Delete 3) Check In 父目錄（VSS 將刪除操作視為目錄變更）

五、VSS 經典疑難雜癥與應對

六、遷移建議：從 VSS 走向現代化

若維護遺留系統，建議漸進式遷移：

1. 只讀模式凍結 VSS： 設置所有用戶為 Read Only，禁止新增提交。
2. 一次性遷移歷史： 使用 vss2git、git-tfs 或商業工具將歷史導入 Git，保留提交時間/作者/註釋。
3. JBuilder 遷移至 IntelliJ IDEA/Eclipse： 導出項目為 Ant/Maven/Gradle 結構，棄用專有 .jpx 格式。
4. 建立 Git 工作流： GitFlow/Trunk-Based Development，配置 CI/CD 管道。

結語

VSS + JBuilder 曾是國內 Java 開發的「標準配置」，其集中式鎖定模式、IDE 深度整合、權限矩陣設計，在當時解決了「多人協作不覆蓋代碼」的核心痛點。雖然今日視角下其單點故障、無分支合併、性能脆弱等短板顯而易見，但理解這套體系的運作邏輯，有助於我們珍視 Git 分布式模型帶來的自由，也能在接手二十年前的遺留項目時，不至於束手無策。技術更迭不息，工程師的適應與重構能力，才是真正的核心資產。