-Werror=警告名是最直接可控的方式，如-Werror=unused-variable，仅将指定警告升级为错误，避免全局-Werror导致的第三方头文件报错、CI构建雪崩及探测逻辑失效等问题。
-Werror= 后接警告名是最直接、最可控的方式，比如 -Werror=unused-variable。它只把这一类警告升级为错误，不影响其他警告的提示能力，也避免了全局 -Werror 带来的误伤。
怎么用 -Werror=xxx 精准升级单个警告
Clang（LLVM 的 C/C++ 前端）支持对特定警告启用 -Werror= 语法，这是比全局 -Werror 更安全的选择：
- 写法必须带等号，且警告名要和
-W后一致：-Werror=unused-parameter，不能写成-Werror unused-parameter（少等号会当成两个独立参数，Clang 报错） - 支持的警告名可查：
clang --help | grep "warning.*error"，或翻阅 Clang 官方文档的 “Diagnostics” 章节 - 在 CMake 中推荐这样写：
target_compile_options(my_target PRIVATE -Werror=unused-variable -Werror=return-type) - 若某警告名不被识别（如旧版 Clang 不支持
-Werror=cast-function-type），会直接编译失败并提示 “unknown warning group”，此时需降级为-Werror或换用#pragma clang diagnostic error
为什么不用全局 -Werror
全局 -Werror 表面省事，实际容易引发构建雪崩：
- 第三方头文件（如 Qt、Boost）可能触发
deprecated-declarations或zero-as-null-pointer-constant等警告，你无法修改，但它们会被强制变成错误 - CI 流水线升级 Clang 版本后，新版本新增的警告（如
-Wstringop-overflow）会突然导致构建失败，排查成本高 - 某些警告本就不该“一刀切”变错误，比如
-Wpadded（结构体填充告警）属于优化建议，而非逻辑缺陷 - CMake 的
check_cxx_source_compiles()等探测逻辑依赖警告不中断编译，加了-Werror可能让探测失效
在代码里临时关闭某个警告（慎用）
仅当必须对接遗留代码、又无法改头文件时，才考虑局部压制。优先级：宏封装 > #pragma > 全局关警告：
- 用
#pragma clang diagnostic error "-Wunused-variable"只对紧随其后的声明生效，比#pragma GCC diagnostic更 Clang 原生 - 更稳妥的是封装宏：
#define MUST_USE __attribute__((warn_unused_result))，把责任前移到函数声明，而不是后置压制调用点 - 绝对不要在头文件顶部写
#pragma clang diagnostic ignored "-Wshadow"——它会让所有包含该头的源文件都丢失该警告，协作时别人根本看不到问题 - 若用了
#pragma，务必配对push/pop，否则作用域溢出：#pragma clang diagnostic push→#pragma clang diagnostic ignored "-Wdeprecated"→#pragma clang diagnostic pop
真正难处理的不是“怎么升错误”，而是判断哪些警告值得升——比如 -Wimplicit-fallthrough 在 switch 里漏写 break 时极可能引发逻辑错误，就该进 -Werror=；而 -Wcovered-switch-default 这种纯风格提示，留作警告更合理。工程中要持续审视警告列表，而不是一次配完就再也不看。
