VS2017编译C++软件遇库未解析外部符号问题求助

嘿，我来帮你捋捋这个未解析外部符号的问题——这在C++编译里简直是家常便饭，但总能找到突破口。你已经做了不少基础设置，那咱们再从几个容易被忽略的点入手排查：

• 确认库文件的匹配性
  首先得搞清楚你加的.lib文件是不是对应Debug x86版本的。很多库会分Debug/Release、x86/x64版本，比如Debug库可能带d后缀（比如foo.lib是Release，food.lib是Debug），如果你在Debug模式下链接了Release版本的库，肯定会出未解析符号。另外，如果这个库是用其他编译器（比如MinGW）或者更高版本VS编译的，也可能因为ABI不兼容导致符号匹配不上。

• 核对函数签名与命名空间
  先看报错的符号是不是带了命名空间？比如你代码里调用的是my_namespace::func()，但库导出的符号没包含命名空间，或者你漏写了using namespace my_namespace;。还要仔细检查函数的参数、返回值类型是不是完全一致——哪怕是int和long这种细微差别，都会导致符号不匹配。如果是重载函数，也要确认你调用的版本和库导出的是同一个。

• 验证库的导出方式
  如果是第三方库，要确保函数是用正确的方式导出的：编译库时用__declspec(dllexport)，使用时用__declspec(dllimport)。如果是静态库，得保证编译静态库时的运行时库、调用约定和你的项目完全一致。
  你可以在VS的开发者命令提示符里运行dumpbin /symbols your_lib.lib命令，查看库里面的符号，然后和报错的未解析符号对比，看看是不是拼写、大小写或者C++名字修饰（mangling）不一致——要是调用的是C语言写的库，别忘了加extern "C"包裹头文件哦。

• 抠细节检查项目设置
  除了“VC目录”和“附加库目录”，你是不是在链接器->输入->附加依赖项里明确添加了对应的.lib文件？有时候路径对了，但没把库列进去，链接器也找不到。
  再仔细核对“运行时库”：Debug模式下通常是Multi-threaded Debug (/MTd)或者Multi-threaded Debug DLL (/MDd)，必须保证你的项目和库的运行时库完全一致——比如库用/MTd，你项目用/MDd，肯定会出问题。
  调用约定也要再确认：如果库用的是__stdcall，而你代码默认是__cdecl，要么在函数声明里明确指定__stdcall，要么在**C/C->高级->调用约定**里统一调整。

• 排查代码里的小疏漏
  有没有可能你漏写了某个函数的实现，或者头文件里的声明和实现不一致？比如头文件里声明void func(int)，但实现是void func(float)，链接器也会报未解析符号。另外，有些第三方库需要定义特定宏才能正确导出符号，比如FOO_DLL之类的，你得在C/C++->预处理器->预处理器定义里加上这些宏。

内容的提问来源于stack exchange，提问作者Qifeng RUAN