LNK2019是链接错误，非编译错误，本质是链接器找不到函数或变量的定义；常见原因包括声明与定义分离缺失、模板实现未置头文件、静态成员未类外定义、源文件未参与编译、库未正确链接或C/C++混用未加extern "C"。
LNK2019 不是编译错误，而是链接失败——编译器知道符号存在（有声明），但链接器翻遍所有 .obj 和 .lib 都没找到它的定义。解决它，核心就一条：确认那个符号的定义确实被编译进了某个目标文件，并且能被链接器看见。
函数或类成员没实现，或者实现写错了位置
最常见的情况：头文件里写了 void foo(); 或 class A { void bar(); };，但没在任何 .cpp 文件里给出具体实现；或者实现了，但拼写不一致（比如声明是 init()，实现写成 Init()）；又或者类内声明了构造函数 Moon::Moon()，却忘了在 moon.cpp 里写 Moon::Moon() { }。
- 检查报错信息里的符号名（如
??0Moon@@QEAA@XZ），用工具（如dumpbin /symbols）或 IDE 的“转到定义”反查是否真有对应实现 - 类内只声明、不实现的成员函数，必须在某个
.cpp中以ClassName::funcName() { ... }形式完整写出 - 空实现也得写，哪怕只是
Moon::Moon() = default;或Moon::Moon() {} - 模板函数/类的定义不能只放在
.cpp里——必须全在头文件中，否则实例化点看不到实现
静态成员变量没在类外定义
声明 static int count; 在类内只是告诉编译器“有这么个东西”，不代表它真实存在。链接器要找的是内存里的那个变量实体，它必须在某个 .cpp 文件里单独定义一次。
- 在某个
.cpp文件顶部（不在任何函数内）写：int MyClass::count = 0; - 不能加
static关键字（类外定义时static是非法的） - 如果用了
inline变量（C++17 起），可直接在类内写inline static int count = 0;，无需类外定义
源文件没参与编译，或者库没正确链接
代码写了，但 .cpp 文件根本没被加入项目，或者虽然加了却被设为“不参与生成”；调用 Winsock、OpenGL、OpenCV 等第三方功能时，只 #include 头文件远远不够，还必须让链接器知道去哪找实现。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
立即学习“C++免费学习笔记（深入）”；
- 右键该
.cpp文件 → “属性” → “常规” → “项类型” 必须是“C/C++ 编译器”，不是“不参与生成” - Winsock 函数（如
getaddrinfo）报__imp_getaddrinfo：需在项目属性 → “链接器→输入→附加依赖项” 加Ws2_32.lib，并确保#include <winsock2.h> - OpenGL 相关符号缺失（如
glClearColor）：除了GL/glew.h或glad.h，还得链接opengl32.lib（Windows 自带）或你用的 loader 库（如glfw3.lib） - 遇到
__imp__malloc_dbg类错误：通常是运行时库不匹配，检查“配置属性→常规→字符集”和“C/C++→代码生成→运行时库”是否与所用库一致（如都选MDd）
C/C++ 混合调用或入口函数不匹配
用 C 写的库在 C++ 里调用，或项目类型（控制台/Windows）和实际入口函数不一致，都会导致名字修饰错位或入口找不到。
- C 函数头文件中加
extern "C"块包裹声明：extern "C" { #include "c_header.h" }，否则 C++ 编译器会做 name mangling，链接器找不到_printf这类 C 符号 - 报
_WinMain@16：说明链接器按 Windows GUI 程序找入口，但你写了main()。进属性 → “链接器→系统→子系统” 改为CONSOLE，同时预处理器定义去掉_WINDOWS、加上_CONSOLE - 报
main未定义：确认项目里真有一个int main()（不是void main()，也不是拼错成mian()），且该文件被编译
真正卡住的时候，别只盯着报错行——先用 dumpbin /symbols xxx.obj 查看目标文件里有没有那个符号的定义；再确认所有相关 .cpp 都参与了构建；最后核对库路径、依赖项、平台配置（x64/x86）、运行时库这三者是否全部对齐。名字修饰、条件编译、inline 规则、模板可见性，这些细节才是 LNK2019 最爱藏身的地方。
