尖括号与引号""的本质区别在于预处理器查找头文件的搜索顺序：只查系统路径，""先查当前源文件目录，再查-I路径，最后退化为行为。
尖括号 "" 的本质区别在哪
区别不在语法层面，而在于预处理器查找头文件时的**搜索顺序不同**。用 时，编译器只查系统路径（如 /usr/include、MSVC 的 SDK 目录）；用 "" 时，**先查当前源文件所在目录**，再查 -I 指定的路径，最后才退化为 的搜索行为。
这意味着：#include "my_header.h" 能找到和 main.cpp 同目录的 my_header.h；而 #include 默认找不到它——除非你显式把当前目录加进 include 路径（如 g++ -I. main.cpp）。
什么时候必须用引号 ""
项目内自定义头文件几乎都该用 ""，尤其是：
- 与源文件处于同一目录或子目录下的头文件（如
src/utils.h被src/main.cpp包含） - 头文件路径含相对路径（如
#include "detail/impl.hpp"） - 你想让 IDE 或构建系统（如 CMake）更容易识别“项目内头文件”，避免误判为系统头而跳过检查
反例：#include 若 config.h 是你生成的本地配置文件，很可能在 CI 环境中因路径未加入 -I 而失败。
立即学习“C++免费学习笔记（深入）”；
什么时候该用尖括号
标准库头文件（。
原因有二：
- 语义清晰：表明这是“外部提供、不随项目移动”的头文件
- 避免意外覆盖：若你项目里不小心建了个
string.h，用#include "string.h"会优先包含它，导致标准库失效；而#include始终走系统路径，更安全
常见错误和陷阱
这些坑实际开发中高频出现：
-
#include "iostream"编译可能通过，但属于未定义行为——标准只要求 - CMake 中混用：用
target_include_directories(myapp PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/inc)后，仍写#include，结果找不到——因为不查PRIVATE路径，得改用SYSTEM或换引号 - Windows 下大小写不敏感掩盖问题，Linux/macOS 下
#include "MyHeader.h"却写了myheader.h文件名，直接报错
最易被忽略的一点：某些构建系统（如 Bazel）或静态分析工具（如 clang-tidy）会根据引号/尖括号类型施加不同检查规则——比如对 "" 内头文件要求路径必须存在且可访问，而对 则放宽。选错符号可能让问题延迟到集成阶段才暴露。
