尖括号<>优先查系统路径，双引号""先查源文件所在目录；标准库头文件必须用<>，自定义头文件应用""，路径解析以包含该指令的源文件目录为基准。
尖括号 <> 和双引号 "" 的搜索路径不同
编译器查找头文件时，<> 优先在系统路径（如 /usr/include、MSVC 的 SDK 目录）里找；"" 先查当前源文件所在目录，再查项目指定的包含路径（-I 或 IDE 中配置的 Additional Include Directories），最后才退化到系统路径。
这意味着：#include "my_header.h" 能找到同目录下的 my_header.h，而 #include <my_header.h> 几乎肯定失败——除非你把它装进了系统头文件目录（不推荐）。
标准库头文件必须用 <>，自定义头文件建议用 ""
C++ 标准规定：标准库头文件（如 <iostream>、<vector>、<memory>）**只能**用 <> 引用。用 "" 虽然某些编译器能碰巧通过（尤其当项目路径混入了系统头路径），但属于未定义行为，跨平台或升级编译器后容易出问题。
自定义头文件（项目内写的 .h/.hpp）应统一用 ""，原因包括：
立即学习“C++免费学习笔记（深入）”；
- 明确表达“这是本地代码”，便于维护和静态分析工具识别
- 避免与同名系统头冲突（比如你写了
"string.h"，用<string.h>会意外引入 C 标准库版本） - 支持相对路径写法，如
"utils/log.h"，且路径解析更符合直觉
预处理阶段就决定路径，跟命名空间或 using 无关
#include 是预处理指令，发生在编译前。它不关心 C++ 命名空间、using 声明，也不受作用域影响。写成 using namespace std; #include <iostream> 或反过来，效果完全一样。
常见误解是以为 "" 会“优先找当前命名空间”，其实根本没这回事——它只管文件系统路径。如果 #include "foo.h" 找不到，错误是 fatal error: foo.h: No such file or directory，不是链接错误，也不是符号未定义。
混合使用时要注意相对路径解析基准
用 "" 包含的路径，是以**包含该 #include 指令的源文件所在目录**为基准的，不是以当前工作目录或构建目录为准。
例如：
project/ ├── main.cpp // #include "utils/helper.h" ├── utils/ │ └── helper.h
此时 main.cpp 中写 #include "utils/helper.h" 才能正确命中；如果写成 #include "helper.h"，编译器会在 project/ 下找，而不是 project/utils/。
容易踩的坑：
- 在
utils/helper.h里再#include "config.h"，它会去project/utils/config.h找，不是project/config.h - IDE 自动生成的 include 可能用绝对路径或错误相对路径，需人工核对
- 用 CMake 的
target_include_directories(... PRIVATE ...)后，仍建议对本模块内头文件用""，对外部模块头文件用<>，保持语义清晰
路径解析细节容易被忽略，尤其在多层子目录或生成中间文件时，出错往往表现为“找不到头文件”，但实际只是相对路径写错了。
