include指令的作用是预处理器将指定头文件内容原样插入当前源文件对应位置，仅作纯文本复制；它支持代码复用、接口与实现分离、条件编译和宏展开，但需防范重复包含和定义冲突。
#include 指令的作用是让预处理器把指定头文件的全部内容原样插入到当前源文件中该指令出现的位置。它不编译、不链接、不运行，只做纯文本复制——这是理解所有问题的前提。
为什么用 #include 而不是直接写代码
避免重复声明：比如 std::vector 的定义只在 <vector> 里写一次，多个 .cpp 文件都能通过 #include <vector> 复用；
分离接口与实现：头文件（.h）放类声明、函数签名，源文件（.cpp）放具体实现，#include 是连接两者的唯一文本通道；
支持条件编译和宏展开：头文件里可以有 #ifdef DEBUG 或 #define PI 3.14159，这些在包含后才对当前编译单元生效。
立即学习“C++免费学习笔记（深入）”；
常见错误现象：error: 'vector' was not declared in this scope，本质就是漏了 #include <vector>，或拼错了文件名。
#include <xxx> 和 #include "xxx" 搜索路径不同
搜索顺序决定你能不能找到文件，也影响编译可移植性：
-
#include <iostream>：只查系统路径（如/usr/include/c++/11/），找不到就报错，不退到当前目录； -
#include "my_header.h"：先查当前源文件所在目录（比如src/utils/my_header.h），再查系统路径； - 如果写成
#include <my_header.h>却把文件放在项目目录下，GCC/Clang 默认不会找到——除非加-I./src手动指定路径； - Windows 上路径分隔符不影响，但大小写敏感与否取决于文件系统，Linux/macOS 下
#include "MyHeader.h"和实际文件名myheader.h不匹配就会失败。
重复包含会导致重定义错误
一个头文件被多个 .cpp 包含，或通过嵌套包含间接引入多次，就会触发类似 error: redefinition of 'class Foo' 的编译失败。
必须用防护机制阻止二次展开：
- 传统方式：
#ifndef FOO_H+#define FOO_H+#endif； - 更简洁可靠的方式：
#pragma once（Clang/GCC/MSVC 全支持，且能正确处理硬链接和符号链接）； - 注意：
#pragma once对路径敏感——同一头文件若通过不同相对路径被包含（如"../inc/foo.h"和"inc/foo.h"），可能被当作两个文件，仍会重复包含；此时只能靠#ifndef守卫。
头文件里不能放变量或函数定义
因为 #include 是文本复制，一旦头文件被两个以上 .cpp 包含，定义就会出现在多个编译单元中，链接时报 multiple definition 错误。
正确做法：
- 头文件只放：
class声明、extern变量声明、inline函数、constexpr、模板定义； - 非内联函数体、全局变量初始化、静态成员定义，必须挪到
.cpp文件里； - 例外：
inline函数和模板函数必须定义在头文件中，否则实例化时找不到定义。
最容易被忽略的是：模板特化（如 template<> struct hash<MyType> { ... };）如果写在头文件里又没加 inline 或 extern，同样会引发 ODR 违规。
