SVN + Apache + AnkhSVN 搭建 Visual Studio 整合版本控制環境完整指南

軟體版本與下載

服務端搭建步驟

1. 安裝 SVN 並配置環境變數

• 解壓至 D:\svn
• 系統 Path 加入 D:\svn;D:\svn\bin

2. 安裝 Apache HTTPD

• 預設安裝路徑（如 C:\Apache2.2）
• 從 SVN bin 複製 mod_dav_svn.so、mod_authz_svn.so 到 Apache modules 目錄

3. 配置 httpd.conf

# 載入模組
LoadModule dav_fs_module modules/mod_dav_fs.so
LoadModule dav_module modules/mod_dav.so
LoadModule dav_svn_module modules/mod_dav_svn.so
LoadModule authz_svn_module modules/mod_authz_svn.so

# SVN 虛擬目錄配置（置於檔案末尾）
<Location /svn>
  DAV svn
  SVNListParentPath on
  SVNParentPath F:/SVNRepository
  
  # Apache 基本認證
  AuthType Basic
  AuthName "Subversion Repositories! Login Needed!"
  AuthUserFile F:\SVNRepository\passwd
  Require valid-user
  
  # SVN 訪問控制
  AuthzSVNAccessFile F:\SVNRepository\svn_authz
</Location>

4. 建立倉庫與權限

• 在 F:/SVNRepository 下建立專案目錄（如 myProject）
• 用 TortoiseSVN 右鍵 → Create Repository Here 初始化倉庫
• 生成密碼檔：htpasswd -c passwd username
• 編寫 svn_authz：

[groups]
developers = user1, user2

[myProject:/]
@developers = rw
* = r

客戶端整合

1. 安裝 TortoiseSVN

• 資源管理器右鍵菜單整合，圖標覆蓋狀態顯示
• 支援所有 SVN 操作（Checkout、Commit、Update、Merge、Log、Blame...）

2. 安裝 AnkhSVN（VS 整合）

• 對應 VS 版本選擇安裝包
• 安裝後 VS「檔案」選單、方案總管右鍵出現 Subversion 選項
• 支援：Pending Changes、History、Merge、Annotate 等視窗內操作

常見問題與排查

• 403 Forbidden：檢查 Apache 權限、AuthzSVNAccessFile 路徑、用戶組配置
• Could not open the requested SVN filesystem：SVNParentPath 路徑錯誤或倉庫未初始化
• AnkhSVN 不顯示：VS 工具 → 選項 → 原始檔控制外掛程式選擇 AnkhSVN
• 圖標覆蓋缺失：TortoiseSVN 設定 → 圖標覆蓋 → 重啟資源管理器

總結

SVN + Apache + AnkhSVN 組合提供了企業級版本控制方案：Apache 提供 HTTP/HTTPS 存取與認證授權，SVN 核心負責版本管理，TortoiseSVN 給予檔案系統級 GUI，AnkhSVN 實現 VS 深度整合。遵循本文步驟可快速落地穩定可用的團隊協作環境。