不能用 if(_debug) 因为预定义宏只在预处理阶段存在，release 模式下 _debug 未定义会导致编译器报错“undeclared identifier”；必须用 #ifdef _debug 或 #if defined(_debug) 进行条件编译。
直接用 _DEBUG 和 NDEBUG 宏做条件编译，但必须用 #ifdef 或 #if defined()，不能直接写 if(_DEBUG) —— 否则在另一种模式下会编译失败。
为什么不能用 if(_DEBUG) 这种写法
预定义宏不是变量，它们只在预处理阶段存在。写 if(_DEBUG) 会让编译器在 Release 模式下尝试读取未定义的标识符 _DEBUG，直接报错 error C2065: '_DEBUG' : undeclared identifier（MSVC）或类似错误（GCC/Clang）。同理，if(NDEBUG) 在 Debug 模式下也会失败。
正确做法是始终走预处理分支：
-
#ifdef _DEBUG→ 仅 Debug 编译时生效 -
#ifdef NDEBUG→ 仅 Release 编译时生效（注意：MSVC 和 GCC/Clang 都默认在 Release 下定义它） -
#if !defined(NDEBUG)→ 等价于 “非 Release”，可兼容自定义构建类型
_DEBUG 和 NDEBUG 的实际定义来源
不同编译器/工具链默认行为不一致，不能假设某一个宏一定存在：
- MSVC（Visual Studio）：Debug 模式自动定义
_DEBUG；Release 模式自动定义NDEBUG - GCC / Clang：默认都不定义这两个宏；需手动加
-D_DEBUG或-DNDEBUG（CMake 中用add_compile_definitions()或target_compile_definitions()） - CMake 构建时，
set(CMAKE_BUILD_TYPE Debug)不会自动加宏，必须显式配置
推荐统一用 NDEBUG 判断 Release，因为它是 C/C++ 标准断言机制依赖的宏（assert 在 NDEBUG 定义时被展开为空），跨平台更稳。
常见误用场景和对应修复
很多代码把调试逻辑硬塞进运行时判断里，导致行为不可控或编译失败：
- 错误：
void log(const char* s) { if(_DEBUG) printf("[DEBUG] %s\n", s); }→ Release 下编译不过 - 正确：
#ifdef _DEBUG void log(const char* s) { printf("[DEBUG] %s\n", s); } #else void log(const char* s) {} #endif - 错误：在头文件里写
static_assert(_DEBUG, "only in debug");→ Release 下触发静态断言失败 - 正确：
#ifdef _DEBUG static_assert(true, "debug-only check"); #endif
特别注意：STL 容器（如 std::vector）在 Debug 模式下可能启用迭代器调试检查，其 ABI 与 Release 不兼容 —— 即使宏判断正确，也不能混用 Debug 编译的库和 Release 编译的主程序。
CMake 中可靠设置宏的方式
靠 IDE 自动生成不可靠，尤其跨平台项目。应在 CMakeLists.txt 中显式控制：
if(CMAKE_BUILD_TYPE STREQUAL "Debug") target_compile_definitions(my_target PRIVATE _DEBUG) elseif(CMAKE_BUILD_TYPE STREQUAL "Release" OR CMAKE_BUILD_TYPE STREQUAL "RelWithDebInfo") target_compile_definitions(my_target PRIVATE NDEBUG) endif
更健壮的做法是去掉对 CMAKE_BUILD_TYPE 的依赖，改用 generator expressions：
target_compile_definitions(my_target PRIVATE $:_DEBUG> $:NDEBUG> $:NDEBUG>)
这样即使使用 Ninja Multi-Config 或 Visual Studio 的多配置生成器也不会出错。
真正容易被忽略的是：宏只影响编译期分支，但有些行为（比如内存初始化为 0xcc、堆调试头、STL 调试钩子）由链接的运行时库决定，和宏无关。光靠 #ifdef 切换日志，掩盖不了 Release 下未初始化变量暴露的问题。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
