ifdef 和 #ifndef 是 C++ 预处理器指令,分别判断宏是否已定义或未定义;#ifndef 常用于头文件卫士防重定义,#ifdef 多用于平台或调试分支编译。

什么是 #ifdef 和 #ifndef
#ifdef 和 #ifndef 是 C++ 预处理器指令,用于在编译前判断某个宏是否已定义,从而决定是否包含某段代码。它们不运行时生效,也不影响可执行文件逻辑,只控制源码“进不进编译器”。
关键区别:#ifdef MACRO 表示“如果 MACRO 已定义”,#ifndef MACRO 表示“如果 MACRO 未定义”——注意不是“值为 0”或“为空”,而是“有没有用 #define 声明过”。
#ifndef 最常见用途:头文件卫士(include guard)
防止头文件被重复包含导致的重定义错误,比如 error: redefinition of 'class Foo'。这是几乎所有 .h 文件开头必写的模式。
#ifndef MY_HEADER_H
#define MY_HEADER_H
class Foo {
public:
void bar();
};
#endif // MY_HEADER_H
-
MY_HEADER_H是任意合法宏名,惯例用大写+下划线+文件名,避免冲突 - 必须配对使用
#ifndef/#define/#endif,缺一不可 - 现代替代方案是
#pragma once,但它是非标准扩展,跨编译器兼容性略弱(Clang/GCC/MSVC 都支持,但某些嵌入式工具链可能不认)
#ifdef 典型场景:平台/配置差异化编译
根据构建环境启用或屏蔽代码分支,比如 Windows 和 Linux 下用不同系统调用,或调试版打印日志、发布版禁用。
立即学习“C++免费学习笔记(深入)”;
#ifdef _WIN32 #include#elif defined(__linux__) #include #endif #ifdef DEBUG std::cout << "Debug mode active" << std::endl; #endif
- 预定义宏如
_WIN32、__linux__、DEBUG通常由编译器或构建系统(CMake、Makefile)注入,不是自己随便写的 - 检查多个宏要用
#if defined(A) && defined(B),不能写#ifdef A && B(语法错误) - 用
#elif而非多个独立#ifdef,避免意外同时触发多个分支
容易踩的坑:宏名拼错、嵌套混乱、忘记 #endif
预处理是纯文本替换,没有作用域和类型检查,出错时编译器报错位置往往在展开后代码上,和原始 #ifdef 行差很远。
- 拼错宏名(如
#ifdef DEGUB)→ 条件永远为假,代码被静默剔除,很难发现 - 嵌套
#ifdef深度大时,靠缩进难判断配对关系,建议每层加注释:#endif // DEBUG - 漏写
#endif会导致后续所有代码被跳过,GCC/Clang 会报error: #endif without #if,但有时只报后续某行“expected unqualified-id”,得往回翻几十行 -
#undef后再#ifdef就是未定义状态,但极少需要主动#undef,除非刻意清除旧宏干扰
最稳妥的做法:所有条件编译块都用 #ifdef/#ifndef 开头,立刻跟 #define(如果是头文件卫士),结尾统一加带注释的 #endif。复杂逻辑优先抽成独立头文件或构建选项,别堆在主逻辑里。











