CMAKE_COMPILE_WARNING_AS_ERROR 并非 CMake 内置变量，设置它无效；应按编译器分别用 target_compile_options 添加 -Werror（GCC/Clang）或 /WX（MSVC），避免全局污染。
为什么 CMAKE_COMPILE_WARNING_AS_ERROR 不起作用？
这个变量在 CMake 3.25 之前根本不存在，CMake 官方从未提供过名为 CMAKE_COMPILE_WARNING_AS_ERROR 的内置变量。直接写 set(CMAKE_COMPILE_WARNING_AS_ERROR ON) 不会触发任何警告转错误行为，也不会报错——它只是静默地定义了一个无意义的缓存变量。
正确做法：按编译器分别设置 -Werror
CMake 没有跨编译器统一开关，必须根据实际使用的编译器（$<cxx_compiler_id></cxx_compiler_id>）手动追加对应标志。常见组合如下：
- Clang / GCC：用
-Werror（或更精细的-Werror=xxx） - MSVC：用
/WX（注意是大写 X，不是 /Wx 或 /wx） - Intel ICC/ICX：也支持
-Werror，但旧版可能需-we
推荐在 CMakeLists.txt 中这样写：
if(CMAKE_CXX_COMPILER_ID MATCHES "GNU|Clang|Intel") add_compile_options(-Werror) elseif(MSVC) add_compile_options(/WX) endif()
更安全的写法：用 target_compile_options 替代全局 add_compile_options
全局设置容易污染子项目或第三方依赖，尤其在使用 find_package 后引入的库可能因 -Werror 编译失败。应优先绑定到具体 target：
立即学习“C++免费学习笔记（深入）”；
add_executable(myapp main.cpp) if(CMAKE_CXX_COMPILER_ID MATCHES "GNU|Clang") target_compile_options(myapp PRIVATE -Werror -Werror=unused-variable) elseif(MSVC) target_compile_options(myapp PRIVATE /WX) endif()
这样还能配合 PRIVATE/INTERFACE 控制传播范围，避免下游误继承。
注意 MSVC 的 /WX 实际效果和陷阱
/WX 并不等价于 GCC 的 -Werror：它只把“等级 ≥ W3 的警告”转为错误（默认警告级别是 /W3），而 /W4 级别警告仍只是警告。如果项目启用了 /W4，又想让所有 W4 警告也变错误，得额外加 /WX- 关闭默认 WX，再用 /we4002 这类逐条开启——实际中极少这么做。
常见误操作：
- 写成
/wx（小写）→ CMake 不报错，但编译器忽略该选项 - 在非 MSVC 环境下硬写
/WX→ 编译器报未知选项错误 - 用
add_definitions(/WX)→ 无效，/WX 是编译器选项，不是预处理器定义
真正跨平台健壮的方案，始终要靠 if(CMAKE_CXX_COMPILER_ID ...) 分支判断，没有捷径。
