这是链接阶段失败，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 掩盖了。
