这是典型的声明存在但定义缺失或不可见问题，根源在于链接器找不到符号实现，常见于函数未定义、源文件未参与编译、模板定义位置不当、静态成员未类外定义、作用域错误或库链接顺序错误等。
函数声明了但链接时报 undefined reference
这是典型的「声明存在、定义缺失或不可见」问题，不是编译错误，而是链接器找不到符号的实现。常见于头文件里写了 void foo();，但对应 foo() 的函数体没被编译进最终目标文件。
- 检查是否漏写了实现：确认
foo()函数体确实写在某个.cpp文件里（不能只在头文件里声明） - 确认该
.cpp文件参与了编译：比如用g++ main.cpp -o app时，如果foo()在util.cpp里，必须一起编译：g++ main.cpp util.cpp -o app - 检查是否误用了
inline或static：加了static void foo() { ... }会让符号仅在当前翻译单元可见，其他文件即使声明了也链接不到 - 注意模板函数：只有声明没有定义（尤其定义在 .cpp 里）会导致链接失败；模板的声明和定义通常得都在头文件中
头文件里声明、实现却在另一个源文件，仍报错
这说明编译系统没把实现所在的源文件纳入构建流程，或者构建规则有误。不是“写了就行”，而是“得让链接器看见它”。
- 用
nm -C your_obj_file.o | grep foo查看目标文件里是否有foo的全局符号（应显示T foo或U foo表示未定义） - 如果是 CMake 项目，确认
add_executable()或add_library()的源文件列表包含了实现foo()的.cpp - Makefile 中检查
OBJS变量是否遗漏了对应.o文件，或依赖关系写错导致该文件根本没被编译 - 注意头文件包含路径：如果声明在
a.h，而a.cpp没包含a.h，可能因参数类型不一致导致生成的符号名不同（如一个用std::string，另一个用char*），链接器视为不同函数
类成员函数声明了但链接失败
类内声明 ≠ 类外实现。尤其当函数体写在类定义内部时是内联的，但如果写在类外又忘了加作用域，就只剩声明。
- 确认类外定义格式正确：
void MyClass::foo() { ... }，漏掉MyClass::会被当成全局函数 - 静态成员变量必须在类外定义一次（哪怕只是
int MyClass::count;），否则链接时报undefined reference to 'MyClass::count' - 虚函数如果没提供定义（哪怕是空实现），且该类被实例化或取地址，也会链接失败
- 注意 const 成员函数的
const修饰符必须声明和定义完全一致，否则符号不匹配
跨语言调用（比如 C++ 调 C 函数）时链接不到
C++ 编译器会对函数名做 name mangling，而 C 不会。直接声明 extern "C" void c_func(); 是必须的，否则链接器找不到对应符号。
立即学习“C++免费学习笔记（深入）”；
- 在 C++ 头文件中引用 C 函数时，必须用
extern "C"包裹声明：extern "C" { #include "c_header.h" } - 如果 C 函数实现在
.c文件里，确保它没被 C++ 编译器编译（即编译命令中不要把.c当作.cpp传给g++） - 检查库依赖顺序：链接时
-lmylib必须放在依赖它的目标文件之后，例如g++ main.o -lmylib，反过来会失败
::”，只会甩一个模糊的符号名给你。 
