重复包含头文件会导致重定义错误，因预处理器多次复制内容；需用#ifndef/defined/#endif三要素防护，宏名须唯一且位置正确，但无法解决模板ODR或全局变量定义等问题。
为什么重复包含头文件会导致编译错误
当多个源文件或同一源文件中多次 #include 同一个头文件（比如 "utils.h"），而该头文件里定义了类、函数声明、宏或全局变量时，预处理器会把内容原样复制多次。这会导致“重定义”错误，例如：error: redefinition of 'class Config' 或 error: variable 'g_debug' defined more than once。
根本原因不是 #include 本身有问题，而是缺乏防止二次展开的机制。C++ 标准不禁止重复包含，但也不保证行为安全 —— 所以必须手动防护。
#ifndef / #define / #endif 的标准写法
这是最通用、可移植性最强的头文件保护方式，所有 C/C++ 编译器都支持。关键在于三要素缺一不可，且命名需唯一：
-
#ifndef UTILS_H：检查宏UTILS_H是否未定义 -
#define UTILS_H：首次包含时定义它，后续再遇到同名#ifndef就跳过整个块 -
#endif：结束条件编译区域
示例（utils.h）：
立即学习“C++免费学习笔记（深入）”；
#ifndef UTILS_H
#define UTILS_H
#include
class Logger {
public:
static void log(const std::string& msg);
};
#endif // UTILS_H
注意：UTILS_H 是惯例命名（文件名大写 + _H），避免用 __ 开头（保留给编译器），也别用纯数字或含点号（如 utils.h 不合法）。
