VS2022 C++14项目引入pthreads库出现未解析符号链接错误

问题场景 #

• 开发环境：Visual Studio 2022社区版，C++14标准，x64平台配置
• 已通过NuGet包管理器安装v2.9.1.4版本的pthreads库
• 编写的线程创建代码如下：

pthread_t threads[ThreadNum];
ThreadData td[ThreadNum];
int rc;
int i;

for (i = 0; i < ThreadNum; i++) 
{
    cout << "Creating Thread " << i << "...\n";

    td[i].threadID = i;
    td[i].message = "Message";

    rc = pthread_create(&threads[i], NULL, TEST_FUNCTION, (void*)(&td[i]));

    if (rc) 
    {
        cout << "Error: Unable to create Thread " << rc << "!\n";

        exit(-1);
    }
}

pthread_exit(NULL);

• 编译时出现链接错误：

LNK2019 unresolved external symbol __imp_pthread_create referenced in function main
LNK2019 unresolved external symbol __imp_pthread_exit referenced in function main
LNK2001 unresolved external symbol __imp_pthread_exit

问题原因及解决步骤 #

LNK2019错误是链接器无法找到pthreads库的实现文件导致的，以下是针对性解决方法：

1. 确认平台与库版本匹配 #

检查NuGet安装的pthreads库是否为x64版本：

• 打开NuGet包管理器→已安装包→查看pthreads的详细信息，确认支持x64平台。若误装x86版本，卸载后重新安装对应x64版本。

2. 添加pthreads导入库到链接器依赖 #

右键项目→属性→链接器→输入→附加依赖项，添加x64平台的导入库文件名：

• x64平台下，导入库为pthreadVC2.lib（可在NuGet安装路径packages\pthreads.2.9.1.4\build\native\lib\x64下找到）

3. 配置预处理器定义 #

右键项目→属性→C/C++→预处理器→预处理器定义，添加对应宏：

• 使用动态库（默认）时，添加PTW32_DLL
• 使用静态库时，添加PTW32_STATIC_LIB

4. 验证包含目录与库目录配置 #

NuGet安装通常会自动配置，可手动确认：

• 包含目录：C/C++→常规→附加包含目录，确保包含$(SolutionDir)packages\pthreads.2.9.1.4\build\native\include
• 库目录：链接器→常规→附加库目录，确保包含$(SolutionDir)packages\pthreads.2.9.1.4\build\native\lib\x64

额外注意事项 #

确保线程函数TEST_FUNCTION的签名符合pthreads要求，必须为：

void* TEST_FUNCTION(void* arg)

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