CMake中启用更多编译警告时出现错误的问题咨询

你尝试在项目中启用更多编译警告并将警告视为错误，最初在CMakeLists.txt中编写了如下代码：

target_compile_definitions(hyper PRIVATE
                           $<$<CXX_COMPILER_ID:MSVC>:/W4 /WX>
                           $<$<NOT:$<CXX_COMPILER_ID:MSVC>>:-Wall -Wextra -Wpedantic -Werror>
                           )

但在Linux环境下使用Clang 14.0.6或GCC 12.1.1编译时，出现macro names must be identifiers错误；改用以下代码则无错误：

target_compile_options(hyper PRIVATE
                       -Werror -Wall -Wextra
                       )

错误原因 #

核心问题是误用了CMake命令：

• target_compile_definitions的作用是向目标添加预处理器宏定义（比如-DDEBUG这类参数），而非编译选项。
• 当你把-Wall、-Werror这类编译警告选项传给target_compile_definitions时，CMake会将其解析为宏定义指令。例如-Wall会被理解为试图定义名为Wall的宏，但-W前缀会导致解析失败——宏名必须是合法的标识符（不能包含-这类符号），最终触发macro names must be identifiers错误。

正确的跨编译器写法 #

要设置编译警告这类编译选项，必须使用target_compile_options命令，配合生成器表达式可以实现跨编译器的统一配置：

target_compile_options(hyper PRIVATE
    $<$<CXX_COMPILER_ID:MSVC>:/W4 /WX>
    $<$<NOT:$<CXX_COMPILER_ID:MSVC>>:-Wall -Wextra -Wpedantic -Werror>
)

关于“此前类似写法正常工作”的说明 #

大概率是记忆偏差：要么之前误将编译选项放在target_compile_options中而非target_compile_definitions，要么是旧版本CMake的解析逻辑存在疏漏，但从CMake的设计意图和标准行为来看，target_compile_definitions从来不是用来传递编译选项的正确方式。

内容的提问来源于stack exchange，提问作者Milan Dierick