最常踩的坑是函数声明但未实现：头文件中声明void log_message()，调用后链接器报错找不到定义；需用grep确认实现位置，补全.cpp中的定义并确保签名、命名空间、作用域完全一致。
函数声明了但没写实现
这是最常踩的坑：头文件里写了 void log_message();，main.cpp 里调用了它，但整个项目里没有任何地方写 void log_message() { ... }。编译器不报错，因为声明合法；链接器直接翻脸，因为找不到定义。
检查方式很简单：grep -r "log_message" *.h *.cpp 看有没有匹配到函数体。没有？那就补上实现，且必须在某个 .cpp 文件里，不能只放在头文件里（除非是内联或模板）。
- 注意 const、引用符、参数类型是否完全一致——
void f(const int&)和void f(int&)是两个符号 - 命名空间别漏掉——声明在
namespace util { void init(); }，实现就得写成namespace util { void init() { ... } } - 类成员函数要带作用域：
MyClass::do_work()，不是裸写do_work()
源文件根本没参与编译链接
你写了 utils.cpp 实现了一堆函数，但编译命令只写了 g++ main.cpp -o app，utils.cpp 像空气一样被忽略。链接器自然找不到里面定义的符号。
手动编译时，所有用到的 .cpp 必须列全：g++ main.cpp utils.cpp logger.cpp -o app。CMake 用户重点检查 add_executable() 的源文件列表，Makefile 用户核对 OBJS 或 SOURCES 变量是否漏项。
立即学习“C++免费学习笔记（深入）”；
- 别依赖“头文件包含”自动拉入实现——
#include "utils.h"不等于utils.cpp被编译 - 如果用了
extern "C"声明 C 函数，确保对应的 C 源文件（如legacy.c）也进了编译命令 - 构建缓存可能残留旧状态，删掉
.o和可执行文件再试一次
静态成员变量没在类外定义
类内声明静态成员是允许的，但定义必须出现在某个 .cpp 文件里。比如：class Config { static int timeout; }; 编译没问题，但链接时报 undefined reference to 'Config::timeout'。
解决办法只有一条：在任意一个 .cpp 文件里（通常选对应类的实现文件），加一行定义：int Config::timeout = 30;。不能加 static 关键字，也不能放头文件里（否则多个翻译单元重复定义）。
- const 静态成员若为字面量类型（如
int、constexpr），可在类内直接初始化，但依然需要类外定义（除非用inline或constexpr） - 静态成员函数不用额外定义，有声明+实现就行
链接顺序或库路径不对
用 -l 链第三方库时，顺序很重要：依赖者靠前，被依赖者靠后。例如程序用了 OpenSSL 的 SSL_connect，就得写成 g++ main.cpp -lssl -lcrypto，反过来会失败。
如果库不在标准路径，仅用 -lmylib 不够，得配合 -L/path/to/lib 指定搜索目录。更稳妥的方式是直接传 .a/.so 路径：g++ main.cpp /opt/mylib/libmylib.a。
- 用
nm -C main.o | grep SSL_connect确认符号确实是未定义状态（U 标记） - 用
ldd ./app看动态库是否加载成功（对 .so） -
pkg-config --libs openssl这类工具能自动生成正确参数，比手写更可靠
nm -C *.o 扫一遍目标文件，看那个报错符号到底在哪一级是 “U”（未定义），就能快速锁定问题源头。 
