头文件路径错误导致#include "xxx.h"报错，因编译器只查当前目录和-i路径、不查系统路径；链接错误undefined reference源于源文件未参与编译或模板/内联函数定义未置于头文件中。
头文件路径不对，#include "xxx.h" 直接报错
类定义通常放在 .h 文件里，实现放在 .cpp 文件里。编译器看到 #include "utils.h" 时，会先查当前目录（即源文件所在目录），再查 -I 指定的路径，**不查系统路径**。如果 utils.h 在 include/ 下，而你没加 -Iinclude，就必然报 fatal error: utils.h: No such file or directory。
常见错误写法：g++ main.cpp -o app（没指定头文件位置）；g++ -Iinclude/ main.cpp -o app（少了个点，include/ 是相对路径但不是“当前目录下的 include”，必须写成 -I./include）。
-
#include "xxx.h"：搜索顺序是「当前源文件所在目录」→ 所有-I路径（从前到后） -
#include <xxx.h></xxx.h>：跳过当前目录，只查-I路径和系统路径（如/usr/include） - 项目结构建议扁平化，比如：
src/main.cpp、src/utils.cpp、include/utils.h，则编译命令统一用-I./include
undefined reference to 'ClassName::func()'
这是链接阶段错误，说明类的成员函数声明在头文件里，但实现（.cpp 中的定义）没参与链接。典型场景：只编译了 main.cpp，漏掉了 utils.cpp —— 即使头文件被正确包含，链接器也看不到函数体。
不能只靠 #include 就让函数“自动出现”。C++ 编译模型是“每个 .cpp 独立编译成 .o，最后所有 .o 合并链接”。漏掉任何一个 .cpp，对应符号就缺失。
- 单命令编译：必须列出所有源文件，例如
g++ -I./include src/main.cpp src/utils.cpp -o app - 分步编译：每个
.cpp都要加-c，生成对应.o，最后一起链接：g++ -c -I./include src/main.cpp -o build/main.o，g++ -c -I./include src/utils.cpp -o build/utils.o，g++ build/main.o build/utils.o -o app - 切记：
.h文件不能单独编译，g++ utils.h必败；只有.cpp、.cc等源文件才能产出目标码
类模板或内联函数在头文件里，但链接仍失败
类模板（如 template<typename t> class Stack { ... };</typename>）和 inline 成员函数，按 C++ 规则必须把完整定义（不只是声明）放在头文件里。否则，即使 .cpp 包含了该头文件，编译器在该 .cpp 里也无法实例化模板或展开内联——因为定义根本没看见。
这不是路径或链接问题，是语言规则。错误现象常表现为：某个 .cpp 用了 Stack<int></int>，但链接时报 undefined reference to 'Stack<int>::push(int)'</int>，哪怕 Stack.h 里写了 push 的实现。
- 解决办法：把模板类/内联函数的全部实现代码（包括函数体）都写进
.h文件，不要拆到.cpp里 - 若非得分离（比如为减少头文件体积），可用显式实例化：在
utils.cpp末尾加template class Stack<int>;</int>，告诉编译器“请为int版本生成代码” - 检查是否误用了
extern template或export（已废弃），这些反而会抑制实例化
构造函数/析构函数未定义，却没报错？
编译器会自动生成默认构造函数、拷贝构造、析构函数等，但前提是“你没声明任何构造函数”。一旦你在头文件里写了 MyClass();（哪怕没实现），编译器就不再生成默认版本——此时若某处调用 MyClass obj;，就会在链接时报 undefined reference to 'MyClass::MyClass()'。
这种错误容易被忽略，因为语法上完全合法，预处理和编译都通过，直到链接才暴露。尤其在多文件项目中，声明和定义分散，更难定位。
- 快速验证：用
nm *.o | c++filt | grep MyClass::MyClass查看哪个.o里真有该符号 - 最稳妥做法：声明了构造函数，就一定要在对应的
.cpp里提供定义（哪怕空实现） - 现代 C++ 推荐用
= default显式要求编译器生成：MyClass() = default;，这样既明确语义，又避免遗漏定义
g++ -E 确认头文件是否真被拉进来了，再用 nm 看符号是否存在，比反复改 #include 更直接。C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
