头文件多次包含会导致重复定义错误，需用#ifndef/#define/#endif防止；宏名须全局唯一且全大写加下划线；#pragma once非标准且有路径识别等局限；头文件中仅可放类定义、inline函数等，不可放非inline函数实现或非constexpr全局变量定义。
为什么头文件会被多次包含
当多个源文件都 #include 同一个头文件，或者头文件之间互相 #include（比如 a.h 包含 b.h，main.cpp 又同时包含 a.h 和 b.h），预处理器就会把同一段声明重复展开。这会导致编译器报错，例如：redefinition of 'class X' 或 multiple definition of 'func()'。
#ifndef / #define / #endif 三件套怎么写
这是最通用、兼容性最强的防止重复包含方式，所有 C++ 编译器都支持：
#ifndef MY_HEADER_H
#define MY_HEADER_H
// 这里放你的类声明、函数声明、constexpr 等
class MyClass {
public:
void do_something();
};
#endif // MY_HEADER_H
关键点：
-
MY_HEADER_H是宏名，惯例用全大写 + 下划线，且必须全局唯一（常用路径转大写_文件名_H，如UTILS_STRING_UTILS_H） - 宏名不能和项目中任何变量、类型、宏重名，否则可能意外屏蔽定义
- 宏定义本身不占运行时空间，只影响预处理阶段
- 不要在头文件末尾加
#undef MY_HEADER_H—— 它本就该一直有效
为什么不用 #pragma once
#pragma once 看起来更简洁，但它不是 C++ 标准，而是编译器扩展：
立即学习“C++免费学习笔记（深入）”；
- 主流编译器（MSVC、Clang、GCC）都支持，但某些嵌入式或老编译器可能不认
- 对符号链接、硬链接、网络挂载路径等特殊文件系统场景，识别可能出错（实际中少见，但确实存在）
- 无法和宏条件编译组合使用（比如你想在
#ifdef DEBUG下才启用某段头内容，#pragma once无能为力） - 如果头文件被不同路径
#include（如"../inc/a.h"和"inc/a.h"），部分旧版编译器可能认为是两个文件，导致失效
哪些内容放进头文件、哪些不能放
即使加了 #ifndef，头文件里放错东西仍会引发链接错误：
- ✅ 允许：类/结构体定义、
inline函数、constexpr变量、模板定义、using声明 - ❌ 禁止：非
inline的函数实现、非constexpr的全局变量定义（如int g_counter = 0;）、静态局部变量定义 - ⚠️ 注意：
const全局变量默认有内部链接（static），所以const int kMax = 100;放头文件里通常安全；但一旦加上extern或取地址，就得小心
真正容易被忽略的是：#ifndef 只防“重复包含”，不防“重复定义”。它解决不了头文件里误写函数体的问题。
