宏定义非类型安全，应在预处理阶段谨慎使用：需括号保护参数、避免副作用、优先用constexpr替代；头文件卫士须唯一命名；字符串化需间接宏；调试用-E查看展开结果。
宏定义不是类型安全的，别拿它替代 constexpr 或 inline 函数
宏在预处理阶段直接文本替换，不经过编译器类型检查。比如写 #define SQUARE(x) x * x，传入 SQUARE(a + b) 会变成 a + b * a + b，结果完全不对。这不是“用法错”，是根本机制决定的——它不认表达式边界。
实际该这么写：#define SQUARE(x) ((x) * (x))，括号包住参数和整个表达式。但即便如此，带副作用的调用（如 SQUARE(i++)）仍会出问题，因为 i++ 被展开两次。
- 优先用
constexpr int square(int x) { return x * x; }替代数值计算类宏 - 宏只适合纯文本场景：条件编译、头文件卫士、日志开关（如
#ifdef DEBUG_LOG） - 避免宏定义变量名或函数名，容易和真实符号冲突，且 IDE 无法跳转、无调试信息
头文件卫士必须用唯一命名，别手滑写成一样的
常见错误是复制粘贴时没改宏名，比如两个头文件都用 #ifndef MY_HEADER_H，结果后包含的那个被跳过。编译器不会报错，但符号可能缺失或重复定义，问题难定位。
正确做法是基于文件路径生成唯一宏名，例如 mylib_utils_h 对应 mylib/utils.h，全大写+下划线+_h 后缀是通用惯例。
立即学习“C++免费学习笔记（深入）”；
- 不要用
__MY_HEADER_H这种双下划线开头——这是保留给实现用的，可能触发未定义行为 - 现代 C++ 可用
#pragma once替代，但跨编译器兼容性略弱（Clang/GCC/MSVC 都支持，但某些嵌入式工具链不保证） - 如果项目要支持极端老旧环境，坚持用
#ifndef+#define+#endif三件套
带参宏的参数不展开宏，除非用 ## 或 # 操作符显式触发
比如定义 #define LOG(level, msg) printf("[%s] %s\n", #level, msg)，调用 LOG(DEBUG, "init") 会输出 [DEBUG] init。但若 #define DEBUG 3，再调用 LOG(DEBUG, "init")，#level 仍展开为字面量 "DEBUG"，不是 "3"。
想让参数先展开再字符串化，得套一层间接宏：
#define STR(x) #x
#define STR2(x) STR(x)
#define LOG(level, msg) printf("[%s] %s\n", STR2(level), msg)这样 LOG(DEBUG, "init") 才会输出 [3] init。
-
##是拼接操作符，用于连接两个 token，如#define CONCAT(a, b) a##b→CONCAT(foo, _bar)得foo_bar - 所有宏操作都在预处理阶段完成，运行时完全不存在；调试器看不到宏，GDB 里也查不到
SQUARE的值 - 宏内不能用 C++11 后特性（如 auto、lambda），连注释都不能跨行（
\续行不算“跨行注释”）
调试宏定义时，gcc -E 和 clang -E 比 IDE 展开更可靠
IDE 的宏展开提示常有缓存或延迟，尤其涉及多层间接宏或条件编译时。最稳的方式是让编译器输出预处理结果：
g++ -E source.cpp | grep "your_macro_name" 或直接 g++ -E source.cpp > out.i 看完整展开。
- 注意：-E 不编译，只做预处理，所以语法错误不会报，但宏替换结果一目了然
- Windows 下 MSVC 用
cl /E source.cpp，输出内容格式略有不同，但逻辑一致 - 如果宏依赖其他头文件里的定义，确保
-I路径正确，否则-E会卡在找不到头文件
宏本身不复杂，难的是它藏在预处理层，既看不见又影响编译语义。真正容易翻车的，永远是那个以为“就展开一下而已”的瞬间。
