add_definitions

提示：文章写完后，目录可以自动生成，如何生成可参考右边的帮助文档

在 CMake 中，add_definitions 是一个用于向编译器添加预处理器定义（preprocessor definitions）的命令。这些定义会影响后续所有目标（如可执行文件、库）的编译过程，相当于在代码中使用 #define 定义宏，或在编译命令中添加 -D （GCC/Clang）或 /D（MSVC）参数。

基本语法

add_definitions(<definition> ...)

其中 <definition> 是预处理器定义，可以是：

• 无值宏（如 DEBUG），需用 -D 前缀（CMake 会自动适配不同编译器的语法）；
• 带值宏（如 MAX_BUFFER=1024）；
• 取消已定义的宏（用 -U 前缀，如 -UDEBUG）。

常见用法示例

1. 添加无值宏

向所有后续目标添加 DEBUG 宏，用于代码中条件编译：

add_definitions(-DDEBUG)  # 等价于代码中的 #define DEBUG

在代码中可这样使用：

#ifdef DEBUG
    printf("Debug mode enabled\n");
#endif

2. 添加带值宏

定义一个带值的宏 MAX_SIZE=2048：

add_definitions(-DMAX_SIZE=2048)  # 等价于 #define MAX_SIZE 2048

在代码中可直接使用该值：

int buffer[MAX_SIZE];  // 等价于 int buffer[2048];

3. 取消已定义的宏

如果之前定义了 DEBUG，可以用 -U 取消：

add_definitions(-UDEBUG)  # 取消 DEBUG 宏的定义

注意事项

1. 作用范围：
   add_definitions 是全局生效的，会影响从该命令开始到后续所有 add_executable 或 add_library 定义的目标。这可能导致不必要的宏污染（例如，某个目标不需要该宏却被强制添加）。

2. 现代 CMake 推荐用法：
   对于 CMake 3.0+，更推荐使用 target_compile_definitions 替代 add_definitions。它可以为特定目标添加宏定义，避免全局污染：

   # 只为 my_target 目标添加 DEBUG 宏（PRIVATE 表示仅该目标内部使用）
   target_compile_definitions(my_target PRIVATE DEBUG)
   

   其中 PRIVATE 可替换为 PUBLIC（目标及其依赖者都生效）或 INTERFACE（仅依赖者生效），更灵活控制宏的作用范围。

3. 平台兼容性：
   CMake 会自动将 -D 转换为对应编译器的语法（如 MSVC 用 /D），因此无需针对不同编译器修改写法。

4. 与 CMAKE_CXX_FLAGS 等的区别：
   add_definitions 专门用于预处理器定义，而 CMAKE_CXX_FLAGS 是添加编译器 flags（如 -Wall 警告选项）。两者作用不同，不应混用。

总结：add_definitions 适合简单场景下添加全局预处理器定义，但现代 CMake 更推荐使用目标级别的 target_compile_definitions 以提高工程的可维护性。