LNK2001/LNK2019错误本质是链接器“看见调用但未找到定义”，主因包括：函数实现未编译、声明与定义签名不一致、静态成员变量未在.cpp中定义、C++调用C函数未用extern "C"、库位数/配置不匹配、DLL导出导入符号缺失或调用约定不一致。
LNK2001 / LNK2019：找不到 _main、WinMain 或自定义函数符号
链接器报这个错，本质是它“看见了调用，但没找到定义”——不是代码写错了，而是定义根本没进链接阶段。常见于把函数声明写了，实现却放在了没编译的 .cpp 文件里，或者忘了加到项目中。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 检查所有
.cpp文件是否实际参与了构建（VS 里右键文件 → “属性” → “常规” → “项类型” 是“C/C++ 编译器”，不是“不参与生成”） - 确认函数定义和声明的签名完全一致：
const、noexcept、参数类型（比如int*和int&不兼容）、调用约定（__cdeclvs__stdcall）都不能差一点 - 类内
inline函数或模板函数，实现必须在头文件里；如果硬要分离，得显式实例化，比如template class MyClass<int>;</int> - Windows 下控制台程序要导出
main，GUI 程序要导出WinMain，且入口函数签名必须匹配项目设置（如子系统是Console却写了WinMain，就会报unresolved external symbol _main）
静态成员变量未定义：报错 LNK2001: unresolved external symbol 指向 ClassName::staticVar
声明不等于定义。类内声明 static int count; 只是告诉编译器“有这么个东西”，真正分配内存的定义必须在某个 .cpp 文件里单独写一次。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 在且仅在一个
.cpp文件中写完整定义：int ClassName::count = 0;（不能带static关键字） - 如果变量是
const且是整型字面量（如static const int MAX = 100;），C++17 前允许只在类内初始化，但若取地址（&ClassName::MAX）仍需外部定义；C++17 起可用inline static彻底解决 - 别在头文件里写非
inline的定义，否则多个.cpp包含后会触发LNK2005: already defined
混用 C 和 C++：printf 正常，但自定义 C 函数报 LNK2019
C++ 编译器会对函数名做 mangling（修饰），而 C 编译器不会。如果你在 C++ 文件里声明了一个 C 函数但没告诉编译器“这是 C 风格”，链接器就找不到那个被修饰过的名字。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 在 C++ 文件中包含 C 头文件时，用
extern "C"包裹：extern "C" { #include "my_c_lib.h" } - 如果自己写 C 函数并想被 C++ 调用，函数定义前也要加
extern "C"（或头文件里用宏判断#ifdef __cplusplus） - 检查 C 库是否提供了
.lib（Windows）或.a/.so（Linux/macOS），并且已添加到链接器输入（VS：项目属性 → 链接器 → 输入 → 附加依赖项） - 64 位程序不能链接 32 位
.lib，反之亦然；Debug 版本通常不能混用 Release 版本的库（因调试信息、运行时库不同）
多模块项目中，DLL 导出/导入符号不匹配
写 DLL 时，如果没正确用 __declspec(dllexport) 标记要导出的函数，或者调用方没用 __declspec(dllimport) 声明，链接器就当它不存在。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 定义一个宏统一处理导出/导入，例如：
#ifdef BUILDING_MY_DLL #define MY_API __declspec(dllexport) #else #define MY_API __declspec(dllimport) #endif
然后在头文件中用MY_API void do_work(); - 确保 DLL 工程的“配置属性 → 常规 → 配置类型”设为“动态库(.dll)”，否则不会生成
.lib导入库 - 调用方必须链接 DLL 对应的
.lib（不是 DLL 本身），且运行时 DLL 必须在 PATH 或可执行目录下 - 注意调用约定：DLL 导出函数默认是
__cdecl，但如果用了__stdcall（如 Windows API），调用方也必须匹配，否则符号名对不上（_func@4vs_func）
最麻烦的其实是跨工具链或跨版本的情况——比如用 MSVC 编译的 DLL，被 MinGW 调用，或者 CMake 里没设好 set(CMAKE_WINDOWS_EXPORT_ALL_SYMBOLS ON) 就指望自动导出。这些地方没报错信息提示，但链接就是死活过不去。
