这是典型的声明存在但定义缺失或不可见问题，根源在于链接器找不到符号实现，常见于函数未定义、源文件未参与编译、模板定义位置不当、静态成员未类外定义、作用域错误或库链接顺序错误等。

函数声明了但链接时报 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 里）会导致链接失败；模板的声明和定义通常得都在头文件中

头文件里声明、实现却在另一个源文件，仍报错

这说明编译系统没把实现所在的源文件纳入构建流程，或者构建规则有误。不是“写了就行”，而是“得让链接器看见它”。

C++14

C++14 对 C++11 的修正与增强版本，适合旧系统维护和较老工具链兼容。

下载

• 用 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 函数时，必须用 extern "C" 包裹声明：

  extern "C" {
  #include "c_header.h"
  }

• 如果 C 函数实现在 .c 文件里，确保它没被 C++ 编译器编译（即编译命令中不要把 .c 当作 .cpp 传给 g++）
• 检查库依赖顺序：链接时 -lmylib 必须放在依赖它的目标文件之后，例如 g++ main.o -lmylib，反过来会失败

实际项目里最常踩的坑是：以为“头文件里声明了，又写了 .cpp，就万事大吉”，结果构建系统压根没编译那个 .cpp，或者定义写错了作用域——链接错误不会告诉你“哪一行少写了 ::”，只会甩一个模糊的符号名给你。

C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！