头文件报错“fatal error: xxx.h: No such file or directory”本质是预处理阶段编译器未找到头文件，需用-I指定路径；链接报错“undefined reference”则因函数实现未参与链接，须确保所有源文件或库正确编译并链接。
直接用 g++ 编译带 #include 的 C++ 文件，只要头文件路径正确、声明定义匹配，就能过；但出错时绝大多数卡在预处理或链接阶段，不是语法问题。
头文件找不到：fatal error: xxx.h: No such file or directory
这是最常见报错，本质是预处理阶段找不到头文件路径。编译器默认只查系统目录（如 /usr/include），不会自动扫描当前目录或子目录。
- 如果头文件和源文件在同一目录，加
-I.：g++ -I. main.cpp -o app - 如果头文件在
./include/下，用-I./include：g++ -I./include main.cpp -o app - 多个路径可用多个
-I，顺序重要——前面的路径优先匹配 - 不要写成
-I include/（少个点），相对路径必须以.或./开头才表示当前目录 -
#include "xxx.h"和#include <xxx.h>搜索路径不同：" "先查当前目录和-I路径，< >只查系统路径和-I路径，不查当前目录
函数未定义：undefined reference to 'xxx()'
这个错误发生在链接阶段，说明预处理和编译都过了，但链接器找不到函数实现。典型场景是头文件里只声明了函数，而实现分散在其他 .cpp 文件里，却没一起编译进去。
- 单命令编译多个源文件：
g++ main.cpp utils.cpp -o app（所有.cpp必须列全） - 分步编译时，每个
.cpp都要加-c生成.o，最后再链接：g++ -c main.cpp→g++ -c utils.cpp→g++ main.o utils.o -o app - 注意：头文件本身不能被
g++直接编译，g++ xxx.h会失败；只有.cpp/.cc等源文件才能参与编译 - 如果用了静态库（
.a）或动态库（.so），得配-L和-l，比如-L./lib -lmyutils
宏或条件编译导致行为异常
头文件里常含 #ifdef、#define，这些在预处理阶段就生效，但你看到的源码里根本没展开，容易误判逻辑。
立即学习“C++免费学习笔记（深入）”；
- 用
g++ -E main.cpp | head -n 50快速看前 50 行预处理结果，确认头文件是否真被展开、宏是否被替换 - 用
-D手动定义宏来切换分支，比如g++ -DDEBUG main.cpp -o app等价于源码开头写了#define DEBUG - 重复包含头文件一般靠
#ifndef XXX_H / #define XXX_H防御，但如果宏名拼错（如XXX_H_多了个下划线），就会失效，引发重定义错误 -
-save-temps会生成.i、.s、.o文件，比单纯用-E更方便反复检查
为什么加了 -std=c++17 还报错？
标准选项只控制语言特性解析，不解决头文件路径或符号缺失。但它会影响某些头文件的存在性与内容——比如 <optional> 在 C++17 才正式引入，用 -std=c++11 编译会直接报 fatal error。
- 确认头文件是否属于所选标准：查 cppreference.com 对应版本文档
- 部分系统旧版 GCC 不自带新标准头文件，即使加了
-std=c++20也无效，得升级 GCC -
-std=gnu++17比-std=c++17多支持 GNU 扩展（如__attribute__），兼容性略宽，但跨平台项目建议用纯c++xx - 别漏掉
-lstdc++：极少数嵌入式或精简环境需显式链接标准库，普通 Linux 发行版通常自动加上
真正麻烦的从来不是“怎么编译”，而是“为什么这行 #include 看似合理却失败”。预处理看不见、链接看不见、宏展开看不见——所有“看不见”的环节，才是调试时最该盯住的地方。
