警告不是噪音，是編譯器發現的潛在缺陷。 將警告視為錯誤（-Werror / /WX）應是專案預設政策。乾淨的編譯輸出（零警告）是代碼品質的基準線。
| 警告類型 | 典型原因 | 修正建議 |
|---|---|---|
| 第三方頭文件警告 | 外部庫代碼不符合本專案警告標準 | 系統頭文件用 -isystem (GCC/Clang) 或包裝 #pragma warning(push, 0) (MSVC) 隔離 |
| 未使用的函數參數 | 介面規範要求但實作不需該參數 | 參數前加 _ 或 (void)param; 明確標記刻意不用 |
| 定義未使用的變數 | 殘留代碼、過度防禦性宣告 | 刪除或標記 [[maybe_unused]] (C++17) / __attribute__((unused)) |
| 變數可能未初始化就使用 | 分支覆蓋不全、複雜控制流 | 定義時初始化、重構簡化邏輯、斷言輔助分析 |
| 遺漏 return 語句 | 非 void 函數控制流可達函數尾部 | 補全所有路徑的 return、或改用 std::optional 表達可失敗 |
| 有號/無號不匹配 | size_t vs int 比較、參數傳遞 | 統一使用 size_t 表示索引/大小、必要時顯式轉換並斷言範圍 |
當確認警告為誤報、或修正成本極高（如侵入式修改第三方庫）時：
#pragma warning(push)
#pragma warning(disable: 4100) // 未使用的形式參數
void legacy_callback(int unused_param) { /* 舊介面要求 */ }
#pragma warning(pop)
_Pragma("GCC diagnostic push")
_Pragma("GCC diagnostic ignored \"-Wunused-parameter\"")
void legacy_callback(int unused_param) { }
_Pragma("GCC diagnostic pop")
-Werror，合併請求 (MR/PR) 必須零警告通過。CMake、.editorconfig、Directory.Build.props 等），避免「我機器上沒警告」的差異。編譯器是最廉價、最早介入、誤報率最低的靜態分析工具。擁抱警告、消除警告，是工程師專業素養的直接體現。
