WSL下pybind11绑定C++时Python版本头文件冲突问题求助

你的问题根源在于：安装Python3.10时未同步安装对应的开发头文件包，导致/usr/include/python3.10不存在；而pybind11默认会根据当前环境的Python版本（你这里是3.10）去查找对应版本的头文件，因此出现找不到目录的错误。复制Python3.8头文件到3.10目录属于临时 workaround，存在版本不兼容风险，以下是更优的解决方案：

方案1：安装Python3.10的开发包（推荐） #

在Debian/Ubuntu系的WSL环境中，直接安装Python3.10的开发依赖包，系统会自动生成/usr/include/python3.10目录并放入对应版本的头文件：

sudo apt-get update
sudo apt-get install python3.10-dev

这是最规范的解决方式，能保证头文件与Python3.10运行时版本完全匹配，避免后续潜在的兼容性问题。

方案2：强制pybind11使用Python3.8 #

如果你不需要切换到Python3.10，只想继续基于Python3.8开发，可以通过CMake指定使用的Python版本：

修改CMakeLists.txt #

在现有配置中添加指定Python版本的代码：

cmake_minimum_required(VERSION 3.4)
project(pybindproject)
# 明确指定使用Python3.8开发包
find_package(Python 3.8 REQUIRED COMPONENTS Development)
add_subdirectory(pybind11)
pybind11_add_module(module_name main.cpp)

或在cmake构建时指定参数 #

无需修改CMakeLists.txt，在执行cmake命令时通过参数指定Python解释器路径：

cmake .. -DPython_EXECUTABLE=/usr/bin/python3.8

为什么不推荐复制头文件的方式？ #

直接复制Python3.8的头文件到Python3.10目录，会导致头文件版本与实际Python3.10运行时不匹配。如果后续代码中用到Python3.10新增的API、或者Python3.8与3.10行为有差异的部分，会出现编译失败、运行时崩溃等难以排查的问题，仅适合紧急临时修复，不适合长期开发。

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