TortoiseSVN 黃色驚嘆號圖標原因與一鍵修復方法

現象說明

在 Windows 檔案總管中，受 TortoiseSVN 版本控制的文件/資料夾圖標出現黃色驚嘆號（⚠），表示該項目存在本地修改衝突或狀態不一致，常見於：

• 文件內容被修改但未提交
• 屬性衝突（如 svn:ignore、svn:externals）
• 樹狀衝突（目錄結構變更衝突）
• 鎖定過期或被盜用

快速修復步驟

1. 在帶驚嘆號的文件或資料夾上右鍵點擊。
2. 選擇 TortoiseSVN → Revert（還原）。
3. 在彈出的對話框中勾選需還原的項目，確定。

效果：工作副本恢復到最近一次 svn update 後的純淨狀態，黃色驚嘆號消失，圖標恢復為綠色勾號（正常）或紅色感嘆號（有衝突需手工解決）。

進階處理：若 Revert 後仍有紅色感嘆號

• Update 衝突：右鍵 → TortoiseSVN → Edit Conflicts 逐個解決，或使用 Resolved 標記為已解決後提交。
• 屬性衝突：右鍵 → TortoiseSVN → Properties 檢查並修正屬性值。
• 樹狀衝突：通常需手動合併目錄結構，或諮詢團隊協作方案。

預防建議

• 养成「小步提交、頻繁更新」習慣，減少衝突窗口。
• 使用 svn lock 機制保護二進制文件（圖片、文檔）避免並發修改。
• 配置 svn:ignore 忽略編譯產物、IDE 配置、日誌等無需版控文件。

命令行等效操作

# 還原單個文件
svn revert path/to/file.php

# 遞歸還原整個目錄
svn revert -R path/to/dir

# 查看狀態確認
svn status
# 輸出首字符：M=修改，C=衝突，?=未受版控，!=缺失，~=類型變更

結語

黃色驚嘆號只是「本地有未提交修改」的友好提醒，Revert 是最快捷的「後悔藥」。遇到紅色感嘆號才需進入衝突解決流程。掌握基本圖標語義與右鍵菜單操作，讓版本控制不再令人焦慮。