这是链接阶段失败，ld 找不到符号定义或库文件；编译器已生成 .o 文件，但链接时因函数未实现、库未链接、源文件遗漏或符号不匹配等导致 undefined reference 错误。
这是典型的链接阶段失败，不是编译错误，ld 找不到符号定义（比如函数体、全局变量）或库文件。
为什么 ld returned 1 exit status 不是编译问题
编译器（如 g++）已成功生成了 .o 目标文件，但链接器 ld 在合并这些文件时失败。常见原因包括：
- 声明了函数（
void foo();）但没实现（缺失void foo() { ... }） - 调用了
main以外的入口函数，而链接器默认找main - 使用了第三方库（如
libcurl），但没加-lcurl或-L/path/to/lib - C++ 源文件没全部传给
g++命令（漏了utils.cpp，只编译了main.cpp）
undefined reference to 是关键线索
完整错误里一定跟着类似 undefined reference to 'foo()' 这样的提示——这才是真正要解决的目标。重点关注它：
- 检查该符号是否在某个
.cpp文件中定义（不是只在.h里声明） - 确认定义的签名和声明完全一致（返回类型、参数类型、
const、noexcept、模板特化等） - 如果是类成员函数，确保写了
ClassName::func()而不是裸写func() - 静态成员变量必须在类外定义一次（即使无初始化值）：
int MyClass::static_var;
用 nm 和 g++ -v 定位缺失环节
别靠猜。直接查目标文件里有没有符号：
立即学习“C++免费学习笔记（深入）”；
nm -C main.o | grep foo
如果输出为空，说明 main.o 没引用到 foo；如果 U foo 出现，说明引用了但未定义。再查实现它的 utils.o：
nm -C utils.o | grep foo
应该看到 T foo（已定义）。若没有，说明 utils.cpp 没被编译，或函数名拼错，或被 #ifdef 掩盖了。
加 -v 看链接命令实际执行了什么：
g++ -v main.o utils.o -o app
观察最后调用 ld 时是否漏了某个 .o，或是否多传了 C 编译的 .o（C++ 符号修饰不同，混用会报 undefined reference）。
常见陷阱：头文件包含 ≠ 符号自动链接
很多人以为 #include "foo.h" 就够了，其实只是引入了声明。实现必须来自：
- 同一个翻译单元（即
foo.h里内联定义，用inline或模板） - 另一个被编译并传入链接器的
.cpp文件 - 静态库（
.a）或动态库（.so），且链接时显式指定
尤其注意：模板函数通常不能分离声明/定义（除非显式实例化），否则链接时找不到定义。
最常被忽略的是：多个源文件编译时忘了把所有 .cpp 列进命令行，或者构建系统（Makefile/CMake）里漏写了源文件路径。链接器不会主动搜索目录，它只处理你明确给它的输入。
