include多次导致重定义错误，因头文件中若含函数实现、全局变量定义等，会被复制多份；卫士仅防重复包含，防重定义需声明与定义分离、inline/constexpr等约束。
为什么 #include 多次会导致重定义错误
因为 C++ 编译器对每个翻译单元（.cpp 文件）单独处理，如果头文件里直接写了函数实现、全局变量定义或 class 外的模板实例化，#include 两次就等于把同一段定义复制粘贴了两遍。链接器一看：两个 foo()，懵了——报 LNK2005 或 duplicate symbol。
卫士（include guard）只解决「重复展开」，不解决「定义泄露」。真正要防重定义，得靠「声明与定义分离」+ 卫士 + inline/constexpr 等约束。
- 头文件里只放声明（
extern int x;）、类定义、内联函数、constexpr变量、模板定义 - 函数体、全局变量初始化、静态成员定义，一律挪到 .cpp 里
- 模板函数和类模板必须完整定义在头文件中（否则链接不到），但本身不产生多份定义，所以安全
#pragma once 和传统卫士怎么选
#pragma once 是编译器扩展，写起来省事，但不是 C++ 标准；传统卫士（#ifndef / #define / #endif）是标准做法，兼容所有环境，包括极端老编译器或某些嵌入式工具链。
实际项目中两者可共存（不影响），但别混用同一头文件——容易漏删、命名冲突、维护混乱。
立即学习“C++免费学习笔记（深入）”；
- 推荐统一用传统卫士，宏名按
PROJECT_MODULE_FILENAME_H格式（如MYLIB_UTILS_STRING_H），全大写+下划线，避免和用户代码冲突 - 不要用简单名如
STRING_H，系统头文件也可能用它，导致意外跳过包含 -
#pragma once在符号链接或硬链接路径不同但文件相同的情况下可能失效（极少见，但真实存在）
哪些内容放进头文件仍会触发重定义
即使加了卫士，以下写法依然危险，一 include 多次就翻车：
-
int global_var = 42;—— 这是定义，不是声明；改成extern int global_var;，并在某 .cpp 中定义 -
void helper() { /* 实现 */ }—— 普通函数实现；改成inline void helper() { ... }或移进 .cpp -
const std::string msg = "hello";—— 非constexpr且非内置类型，C++17 前每个 TU 生成独立副本；改用inline const std::string msg = "hello";（C++17 起）或 extern + 定义分离 - 显式模板实例化声明（
template class std::vector<int>;</int>）放在头文件里 —— 必须确保只出现一次，通常应放在 .cpp
卫士宏名写错的典型表现和检查方法
宏名拼错、大小写不一致、漏下划线，都会让卫士失效，表现为：明明写了卫士，却仍报重定义。错误信息里常带「multiple definition of `xxx`」或「redefinition of `class YYY`」。
- 检查宏名是否和头文件路径/名称严格对应，比如
container/list.h→CONTAINER_LIST_H，不是LIST_H或CONTAINER_LIST_H_ - 用编译器预处理输出验证：
g++ -E list.h | grep CONTAINER_LIST_H，看宏是否被正确定义和条件跳过 - 别用
__开头的宏名（如__LIST_H__），这是保留给编译器/标准库的，可能引发未定义行为
卫士只是第一道防线，真正的重定义风险藏在「头文件里悄悄写了定义」这个习惯里。很多人加了卫士就以为万事大吉，结果在 CI 上突然链接失败——问题往往出在那行没加 inline 的函数，或者那个没声明成 extern 的变量。
