Visual Studio中pybind11绑定Python与C++时PYBIND11_MODULE引发LNK2001错误

问题核心原因 #

__imp_PyThread_tss_create是Python 3.8线程本地存储相关的符号，出现未解析错误通常是Python库链接不匹配或项目配置错误导致的，以下是针对性解决方案：

1. 匹配Python库与编译架构/配置 #

• 架构一致：确认VS项目的平台（x86/x64）与你安装的Python 3.8版本完全匹配。比如项目是x64，必须使用Python 3.8 x64安装目录下的python38.lib（Release模式）或python38_d.lib（Debug模式）。
• 配置对应：Debug模式下必须链接调试版Python库python38_d.lib，Release模式下链接python38.lib，禁止跨配置混用库文件。

2. 修正项目配置类型 #

pybind11生成的Python扩展模块本质是特殊的DLL，需调整项目配置：

• 打开「配置属性/常规/项目默认值/配置类型」，选择动态链接库(.dll)。
• 在「链接器/高级/目标文件扩展名」中设置为.pyd，生成的文件才能被Python识别为可导入模块。

3. 调整代码与预处理器定义 #

• 移除手动添加的#include <Python.h>，pybind11的头文件会自动正确引入Python API，避免版本冲突。
• 确保「C/C++/预处理器/预处理器定义」中包含：WIN32;_WINDOWS;，pybind11会自动处理模块导出逻辑，无需额外添加自定义导出宏。

4. 验证Python路径正确性 #

• 确认「VC++目录/包含目录」中的Python路径是Python 3.8安装目录下的include文件夹（而非其他Python版本的路径）。
• 确认「VC++目录/库目录」中的Python路径是Python 3.8安装目录下的libs文件夹。

5. 检查自定义函数实现 #

确保你绑定的kmeans函数已经有完整的实现（头文件声明+源文件定义），如果该函数未实现也会引发链接错误，需优先排查此点（若Python库配置无误时）。

完成以上步骤后，清理项目并重新编译，即可解决__imp_PyThread_tss_create未解析的问题。

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