正确方式是在 configurePresets 的 cacheVariables 中使用 "CMAKE_COMPILE_DEFINITIONS:STRING": "DEBUG;ENABLE_LOGGING"，或用不同 preset 按系统设布尔值，并配合 CMAKE_EXPORT_COMPILE_COMMANDS 与删除缓存确保生效。
configurePresets.json 里怎么写宏定义才跨平台生效
宏定义在运行期注入，不是靠 #define 硬写进代码，而是通过 CMake 的 target_compile_definitions() 或 add_compile_definitions() 注入编译器命令行。但 VSCode + CMake Tools 下，这些定义必须由 CMakePresets.json 统一声明，否则 Windows/macOS/Linux 上行为不一致。
常见错误是把宏塞进 cacheVariables 里，比如 "CMAKE_CXX_FLAGS": "-DDEBUG=1" —— 这会被 CMake 忽略或覆盖，因为 CMake 不通过 CMAKE_CXX_FLAGS 传宏，而用专用机制。
- 正确方式：在
configurePresets的cacheVariables中使用CMAKE_CXX_STANDARD同级字段，例如："CMAKE_COMPILE_DEFINITIONS:STRING": "DEBUG;ENABLE_LOGGING;TARGET_LINUX" - 更推荐方式：用
environmentVariables配合set(CMAKE_EXPORT_COMPILE_COMMANDS ON)，让compile_commands.json自动包含所有定义（IntelliSense 和构建同步） - Windows 上若用 MSVC，
DEBUG宏需额外加/D_DEBUG形式，但CMAKE_COMPILE_DEFINITIONS会自动转成对应格式，不用手动处理
为什么 #ifdef DEBUG 总是不生效
不是代码写错了，而是 CMake 没把宏真正传给编译器。VSCode 的 C/C++ 插件读的是 compile_commands.json，如果里面没出现 -DDEBUG，IntelliSense 就当它不存在，跳转、补全、标红全乱套。
检查方法：打开 build/compile_commands.json，搜索你的宏名（如 DEBUG），看是否出现在某条命令的 command 字段里。没出现 = 没注入成功。
立即学习“C++免费学习笔记（深入）”；
- 确认
CMakeLists.txt里有project(...)之后立即启用set(CMAKE_EXPORT_COMPILE_COMMANDS ON) - 确保
CMakePresets.json中的configurePreset显式设置了cacheVariables，而不是只靠cmake.configureSettings里临时加参数 - Mac 上注意：Clang 对
__APPLE__等内置宏敏感，别用set(CMAKE_CXX_FLAGS "-D__APPLE__")覆盖它，应让 CMake 自动推导
跨平台条件宏怎么根据 OS 自动切换
不要手写 #ifdef _WIN32 或 #ifdef __linux__ 然后硬编码逻辑，CMake 可以帮你生成带条件的宏定义，且保证和实际构建环境一致。
典型场景：Linux 上需要 ENABLE_EPOLL，Windows 上需要 ENABLE_IOCP，macOS 上需要 ENABLE_KQUEUE。靠 find_package() 或 check_include_files() 判断太重，直接用 CMake 内置变量更轻量。
- 在
CMakePresets.json的cacheVariables中写："ENABLE_EPOLL:BOOL": "${os == 'Linux'}"—— 不，CMake 不支持这种语法；正确做法是用不同 preset 分离："linux-debug"preset 里设"ENABLE_EPOLL:BOOL": "ON"，"win-debug"preset 里设"ENABLE_IOCP:BOOL": "ON" - 更灵活方案：在
CMakeLists.txt中用if(WIN32)/if(APPLE)/if(UNIX AND NOT APPLE)块，配合target_compile_definitions(my_target PRIVATE ...)，这样宏只对目标生效，不污染全局 - 避免用
add_definitions()全局注入——它会让所有 target 都带上该宏，哪怕只是工具链里的辅助程序
运行期宏定义被覆盖或丢失的隐性原因
最常被忽略的一点：CMake 缓存里旧的宏定义不会自动清除。你改了 CMakePresets.json，但没删 build/ 目录，CMake 就沿用上次 configure 时缓存的 CMAKE_COMPILE_DEFINITIONS，导致新宏根本没生效。
- 每次修改
cacheVariables中的宏定义，必须手动触发CMake: Delete Cache and Configure（不是普通 Configure） - 如果项目用了
add_subdirectory()引入子模块，子模块的CMakeLists.txt可能调用add_compile_definitions()覆盖父级定义，检查子模块是否无脑设了DEBUG导致冲突 - 第三方库（如 spdlog、fmt）自带宏开关（
SPDLOG_FMT_EXTERNAL），它们可能通过find_package()自动注入，优先级高于你手动写的，需要用set(... CACHE INTERNAL "")锁定值
跨平台宏注入真正难的不是写法，而是让 CMake 的缓存、preset、target scope、IntelliSense 数据流全部对齐——漏掉任意一环，#ifdef 就像幽灵一样时有时无。
