SVN 徹底刪除文件/目錄歷史記錄：svndumpfilter 實戰與誤刪恢復全指南

為什麼需要徹底刪除？

SVN 設計初衷是保留完整歷史，但某些場景必須從倉庫中永久清除數據：

• 誤提交了敏感信息（密鑰、密碼、證書）
• 大型二進制文件佔用過多存儲空間
• 法律合規要求刪除特定數據
• 清理無用舊分支/標籤釋放空間

核心工具：svnadmin + svndumpfilter

標準流程：「導出 → 過濾 → 創建新倉庫 → 導入 → 替換」

步驟 1：導出完整倉庫

svnadmin dump /data/svn/project > project_original.dump

導出包含所有版本、所有變更的完整數據流。

步驟 2：過濾掉不需要的路徑

# 排除單個文件
type project_original.dump | svndumpfilter exclude trunk/test.exe > project_new.dump

# 排除整個目錄
type project_original.dump | svndumpfilter exclude trunk/notallowed > project_new.dump

# 組合排除
type project_original.dump | svndumpfilter exclude trunk/test.exe trunk/notallowed > project_new.dump

關鍵參數：

• exclude：排除指定路徑（支持正則）
• --drop-empty-revs：刪除因過濾導致變更為空的版本
• --renumber-revs：重新編號版本號，保持連續性

步驟 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
mv /data/svn/project_new /data/svn/project

注意：操作前務必備份，並通知所有用戶重新檢出。

Windows 環境下的路徑寫法

> svnadmin dump E:/svn/project > aaa.dump
> type aaa.dump | svndumpfilter exclude /Software/Tags/test.exe > bbb.dump
> svnadmin create E:/svn/project_new
> svnadmin load E:/svn/project_new < bbb.dump

大倉庫性能優化策略

• 分批處理：使用 -r START:END 分段導出
• 外部存儲：掛載大容量磁盤存放 dump 文件
• svndumpfilter3（SVN 1.10+）：更快的過濾實現
• 考慮遷移到 Git（配合 BFG Repo-Cleaner）更高效

誤刪恢復：兩大主流客戶端操作

TortoiseSVN (Windows)

1. 右鍵工作副本 → Show log
2. 搜索/定位到刪除該文件/目錄的版本
3. 右鍵該版本 → Revert changes from this revision
4. 文件恢復到工作副本，確認後 Commit

Eclipse Subclipse

1. Team → Show SVN Repository History
2. 找到刪除版本，右鍵 → Revert to this version
3. 同步到工作副本，Commit 提交

命令行恢復（通用）

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

# 恢復特定版本的文件
svn merge -c -REVISION_URL .
# 或
svn copy -r REVISION URL/FILE@REVISION LOCAL_PATH
svn commit -m "Restore deleted file"

最佳實踐總結

SVN 歷史重寫屬高危操作，生產環境務必嚴格遵循「備份 → 測試驗證 → 通知團隊 → 執行替換」流程。