SVN 徹底刪除文件/資料夾與恢復完整指南

前言

SVN 預設不支援徹底刪除歷史記錄中的檔案（為了版本控制完整性）。但某些情況下（敏感資料洩漏、巨大二進位檔佔用空間、誤提交機密資訊），必須從版本庫中永久抹除。本文介紹基於 svnadmin dump/filter/load 的標準方案，並說明恢復誤刪檔案的方法。

核心原理

SVN 版本庫匯出 → 過濾排除目標路徑 → 建立新版本庫 → 匯入過濾後的資料 → 替換原版本庫

操作步驟（伺服器端）

假設環境

• 版本庫路徑：/data/svn/project
• 要刪除：trunk/test.exe、trunk/notallowed/ 目錄
• 工作目錄：/tmp/svn-cleanup

1. 匯出完整版本庫

cd /tmp/svn-cleanup
svnadmin dump /data/svn/project > project_original.dump

project_original.dump 包含所有版本、所有變更歷史。

2. 過濾排除目標路徑

# Linux/Unix
cat project_original.dump | svndumpfilter exclude trunk/test.exe trunk/notallowed > project_new.dump

# Windows (cmd)
type project_original.dump | svndumpfilter exclude trunk/test.exe trunk/notallowed > project_new.dump

# Windows (PowerShell)
Get-Content project_original.dump | svndumpfilter exclude trunk/test.exe trunk/notallowed > project_new.dump

• exclude 參數支援多個路徑，路徑相對於版本庫根目錄
• 若路徑包含空格，需用引號包裹
• 過濾過程會重新計算版本號，被排除路徑的版本會消失

3. 建立新版本庫並匯入

svnadmin create /data/svn/project_new
svnadmin load /data/svn/project_new < project_new.dump

4. 替換原版本庫

# 備份原版本庫（謹慎！）
mv /data/svn/project /data/svn/project_backup_$(date +%Y%m%d)

# 重命名新版本庫
mv /data/svn/project_new /data/svn/project

# 修正權限（視部署用戶而定）
chown -R svn:svn /data/svn/project
chmod -R 770 /data/svn/project

另一個範例：刪除特定檔案

版本庫：E:/svn/project
結構：QA/Trunk、Software/Tags/test.exe
目標：刪除 Software/Tags/test.exe

# 1. 匯出
svnadmin dump E:/svn/project > aaa.dump

# 2. 過濾（注意路徑以 / 開頭）
type aaa.dump | svndumpfilter exclude /Software/Tags/test.exe > bbb.dump

# 3. 建立新庫並匯入
svnadmin create E:/svn/project_new
svnadmin load E:/svn/project_new < bbb.dump

# 4. 替換
rename E:/svn/project E:/svn/project_old
rename E:/svn/project_new E:/svn/project

注意事項與限制

大型版本庫優化策略

• 分批處理： 使用 svnadmin dump -r 0:10000 分段匯出、過濾、匯入
• 壓縮傳輸： svnadmin dump | gzip > dump.gz、zcat dump.gz | svndumpfilter ... | svnadmin load
• 掛載大磁碟： 將工作目錄放在大容量、高速磁碟（SSD/NVMe）
• 離線操作： 停止 SVN 服務（svnserve 或 Apache）避免並發寫入

SVN 恢復已刪除檔案/資料夾

若只是誤刪（而非需徹底抹除歷史），使用標準 SVN 恢復功能即可，無需上述複雜操作。

方法一：TortoiseSVN (Windows GUI)

1. 在本地工作副本右鍵 → TortoiseSVN → Show log
2. 在日誌中找到刪除該檔案/資料夾的版本（可用搜尋）
3. 右鍵該版本 → Revert changes from this revision
4. 檔案恢復到工作副本，確認無誤後 Commit

方法二：Eclipse Subclipse 插件

1. 專案右鍵 → Team → Show SVN Repository History
2. 找到刪除版本，右鍵 → Revert to this revision
3. Commit 恢復變更

方法三：命令列

# 查看刪除歷史
svn log -v | grep -B5 "D.*filename"

# 假設刪除發生在版本 1234
# 恢復到 1233 版本的狀態
svn merge -r 1234:1233 ^/path/to/deleted/item
# 或直接複製舊版本
svn copy -r 1233 ^/path/to/deleted/item ^/path/to/restore/item -m "Restore deleted item"

# 提交
svn commit -m "Restore accidentally deleted file/folder"

方法四：直接在瀏覽器操作（WebSVN/ViewVC）

• 瀏覽版本庫歷史，找到刪除版本
• 下載該版本前的檔案內容
• 手動加入工作副本並提交

預防措施

1. 預提交鉤子： 攔截包含敏感檔案、過大檔案的提交
2. 權限控制： 限制誰可以刪除、誰可以提交二進位檔
3. 定期備份： svnadmin hotcopy 熱備份版本庫
4. Git 替代： 新專案考慮 Git，git filter-branch 或 BFG Repo-Cleaner 處理歷史清理更強大

結語

SVN 徹底刪除歷史檔案需謹慎操作：dump → filter → load → replace 是標準流程，但會改變版本號、需足夠空間與時間、所有客戶端需重新檢出。誤刪檔案恢復則簡單得多，使用 Show log → Revert 或 svn merge/copy 即可。建議建立預防機制，避免頻繁進行歷史重寫操作。