CMake自定义编译宏：用target_compile_definitions消除配置警告

正确使用target_compile_definitions实现调试宏开关 #

你之前注释的写法不生效，核心原因几乎都是配置顺序错了：target_compile_definitions是绑定到具体已存在目标的命令，如果你把这段逻辑写在了project()声明之前，或者写在了add_executable/add_library创建目标之前，${PROJECT_NAME}为空，编译定义根本不会挂载到实际目标上，自然不会生效。
不需要写冗余的if-else分支，正确写法如下：

# option声明要放在全局可执行到的作用域，不要嵌套在永远不命中的判断块里
option(MY_FLAG "Enable debug macro MY_FLAG_DEBUG" OFF)

# 必须先创建目标，再配置目标的编译属性
# 如果你的目标是动态/静态库，把add_executable换成add_library即可，逻辑完全一致
add_executable(${PROJECT_NAME} main.cpp)

# 写法1：通过if判断追加宏，可读性更强
set(PRIVATE_COMPILE_DEFS "${PROJECT_NAME}_BUILDING_DLL")
if(MY_FLAG)
  list(APPEND PRIVATE_COMPILE_DEFS MY_FLAG_DEBUG)
endif()
target_compile_definitions(${PROJECT_NAME} PRIVATE ${PRIVATE_COMPILE_DEFS})

如果想要更精简的写法，也可以用CMake生成器表达式省去单独的if块，效果完全一致：

# 写法2：生成器表达式实现条件宏
target_compile_definitions(${PROJECT_NAME} PRIVATE
  "${PROJECT_NAME}_BUILDING_DLL"
  $<$<BOOL:${MY_FLAG}>:MY_FLAG_DEBUG>
)

两种写法逻辑相同：当MY_FLAG为ON/TRUE/1这类真值时，才会给编译单元添加MY_FLAG_DEBUG宏，源码中包裹在#ifdef MY_FLAG_DEBUG里的调试代码就会被编译进产物。

消除"Manually-specified variables were not used"警告 #

这个警告的触发逻辑很简单：你通过命令行-D传入了MY_FLAG参数，但CMake解析所有配置的过程中，从未读取过这个变量的值，就会提示你传入了未使用的参数。
按照上述写法调整后，满足以下两点就不会再触发该警告：

• option(MY_FLAG ...) 声明在CMake正常执行流能走到的全局作用域，不要藏在永远不会进入的判断分支中
• 后续配置逻辑中确实引用、判断过MY_FLAG的值（上述两种写法里的if判断、生成器表达式的变量引用都属于有效读取）
  如果调整配置后警告仍然存在，直接删除整个build目录重新执行CMake配置即可——旧CMake缓存中残留的历史传参记录也会导致误报警告。

踩坑提醒 #

所有target_*开头的现代CMake命令，包括target_compile_definitions、target_include_directories、target_link_libraries，都必须在对应目标创建完成之后调用，提前调用不会有任何效果，也不会抛出明确的错误提示，是非常常见的新手坑。

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