include是预处理器指令，将头文件内容原样插入；需用#ifndef或#pragma once防重复包含；头文件应自完备、明确依赖、只声明不定义实现。
头文件包含不是简单的文本复制粘贴，而是一套由预处理器驱动、受路径规则和重复保护影响的编译前期机制。
include的本质是预处理指令
#include 是 C++ 预处理器（preprocessor）指令，发生在编译器真正解析语法之前。它会让预处理器把指定文件的**全部内容原样插入**到当前行的位置，不加判断、不改逻辑、不检查类型。
-
#include
：从标准库路径查找，通常对应系统或编译器自带的头文件（如 /usr/include/c++/11/vector） - #include "myheader.h"：先在当前源文件所在目录找，找不到再按系统路径搜索，适合项目内自定义头文件
头文件为什么需要防止重复包含
一个头文件被多个源文件包含，或被其他头文件间接包含多次，会导致符号重定义错误（比如类重复声明、const 变量重复定义）。预处理器本身不会去重，必须靠人工防护。
- 用 #ifndef MYHEADER_H / #define MYHEADER_H / #endif 包裹头文件内容（传统卫士宏）
- 现代写法直接用 #pragma once（非标准但主流编译器都支持，更简洁）
- 两者效果等价：确保该头文件内容在单个翻译单元中只展开一次
包含顺序和依赖关系很重要
头文件之间有隐含依赖。例如 A.h 用到了 B.h 中定义的类，那么 A.h 必须在自身内部 #include "B.h"，不能指望使用者“手动补全”。否则：
立即学习“C++免费学习笔记（深入）”；
- 单独编译包含 A.h 的源文件会失败（找不到 B 的定义）
- 头文件应尽量自完备（self-contained），即能独立编译通过
- 避免在头文件里用 using namespace std;，防止污染包含者的命名空间
头文件里该放什么、不该放什么
头文件是接口契约，不是实现仓库。
- ✅ 放：类声明、函数声明、模板定义、内联函数、constexpr 变量、类型别名（typedef / using）
- ❌ 不放：非 inline 的函数定义、全局变量定义（除非 extern 声明）、静态局部变量、普通变量初始化
- ⚠️ 模板例外：因为实例化需在编译期完成，模板声明和定义通常都得放在头文件里
基本上就这些。理解 include 是预处理行为、学会用防护机制、理清依赖、守住头文件职责边界——C++ 头文件就能稳稳工作。
