LNK2019错误在链接阶段报出，因编译器仅检查声明、不验证定义，链接器才查找符号实现；常见原因包括声明与定义分离、命名修饰不匹配、目标文件未参与链接、DLL导出/导入配置错误、模板或inline函数定义不可见等。
为什么 LNK2019 错误总在链接阶段才报？
因为编译器只检查函数声明是否存在，不验证实现；链接器才真正去找 _C++ 符号对应的定义。一旦声明和定义分离不当、命名修饰不匹配或目标文件没参与链接，LNK2019 就立刻出现。
常见诱因包括：
-
inline函数只在头文件中声明但未定义（或定义不在所有使用它的编译单元可见） - 类成员函数声明在头文件，但定义写在
.cpp文件里，而该.cpp没被加入项目或没编译 - 调用了
extern "C"声明的 C 函数，但实际链接的是 C++ 编译的目标文件（符号名不一致） - 模板函数定义放在
.cpp中，而实例化发生在其他编译单元（模板必须定义可见）
__declspec(dllimport) 和 __declspec(dllexport) 配置错位
Windows 动态库导出/导入声明不一致是高频原因。比如头文件中写了 __declspec(dllimport)，但链接时却没提供对应 DLL 的 .lib，或者反向：本该导出却漏了 __declspec(dllexport)。
正确做法：
立即学习“C++免费学习笔记（深入）”；
- 用宏统一控制：定义
MYLIB_EXPORTS时用__declspec(dllexport)，否则用__declspec(dllimport) - 确保 DLL 工程开启了
/MD或/MT与主工程一致，否则运行时 CRT 不兼容也会间接导致符号找不到 - 检查生成的
.lib是否真被链接器读取——在项目属性 → 链接器 → 输入 → 附加依赖项中确认名称，且路径在“常规 → 附加库目录”中已配置
模板和内联函数定义不能只放在 .cpp 文件里
C++ 模板实例化发生在使用点，链接器不会跨编译单元合成模板函数。如果把 template void foo(T); 的定义写在 foo.cpp，而 main.cpp 调用了 foo(42)，链接时必然报 LNK2019。
