🎯 什麼情境該想到我
當你看到「永遠不會被執行、或已經沒有任何地方在使用」的程式碼——被註解掉的舊實作、再也沒人呼叫的函式、不可能成立的條件分支——它們只會增加閱讀時的負擔。
⚙️ 怎麼用(步驟 / 公式)
意圖:把死掉的程式碼刪掉。留著它不會帶來價值,只會讓讀者以為「這還有用」而多花心力理解。有版本控制在,需要時隨時能找回來。
小步安全進行:
- 確認這段程式碼真的沒有被使用(用工具搜尋呼叫端、靜態分析找不可達碼)。
- 若它曾對外公開(是 API),先確認外部確實沒有依賴。
- 直接刪除,不要用註解「暫時封存」——那只是另一種雜訊。
- 執行測試,確認沒有東西壞掉。
🧪 我實際套用的紀錄
- (待填)
⚠️ 注意 / 什麼時候不適用
- 「可能之後會用到」不是保留的理由——版本控制就是你的還原機制,別靠註解保存。
- 對外公開的介面要先確認沒有隱形依賴(反射、動態呼叫、外部呼叫端)再刪。
- 不確定是否真的無用時,先加日誌/監控觀察一段時間,再決定刪除。
🔗 相關工具
- 移除旗標參數 Remove Flag Argument(拆掉旗標後常會暴露出從此走不到的死分支)
- 以多型取代條件式 Replace Conditional with Polymorphism(重構條件式後常清出不再需要的分支)
- 重構