🎯 什麼情境該想到我

當你看到「永遠不會被執行、或已經沒有任何地方在使用」的程式碼——被註解掉的舊實作、再也沒人呼叫的函式、不可能成立的條件分支——它們只會增加閱讀時的負擔。

⚙️ 怎麼用(步驟 / 公式)

意圖:把死掉的程式碼刪掉。留著它不會帶來價值,只會讓讀者以為「這還有用」而多花心力理解。有版本控制在,需要時隨時能找回來。

小步安全進行:

  1. 確認這段程式碼真的沒有被使用(用工具搜尋呼叫端、靜態分析找不可達碼)。
  2. 若它曾對外公開(是 API),先確認外部確實沒有依賴。
  3. 直接刪除,不要用註解「暫時封存」——那只是另一種雜訊。
  4. 執行測試,確認沒有東西壞掉。

🧪 我實際套用的紀錄

  • (待填)

⚠️ 注意 / 什麼時候不適用

  • 「可能之後會用到」不是保留的理由——版本控制就是你的還原機制,別靠註解保存。
  • 對外公開的介面要先確認沒有隱形依賴(反射、動態呼叫、外部呼叫端)再刪。
  • 不確定是否真的無用時,先加日誌/監控觀察一段時間,再決定刪除。

🔗 相關工具