Windows下CMake编译pybind11示例项目遇python312.lib链接错误

在Windows系统使用CMake编译pybind11示例项目时，出现链接错误：LINK : fatal error LNK1104: cannot open file 'python312.lib'，已通过pip install "pybind11[global]"安装pybind11，手动添加过Python头文件路径，Linux环境下无此问题，暂不考虑将pybind11作为Git子目录引入。

解决方案 #

1. 确认python312.lib文件存在且安装路径正确 #

Windows下Python的pythonXX.lib默认存放在Python安装目录的libs文件夹中。如果该文件缺失，大概率是Python安装时未勾选完整组件：

• 重新运行Python安装包，选择自定义安装，确保勾选「Install for all users」（或至少勾选「Development files」相关选项）；
• 检查Python安装目录下的libs文件夹，确认python312.lib存在（Release编译只需该文件，Debug版本可能需要python312_d.lib）。

2. 修改CMakeLists.txt显式关联Python开发环境 #

修改你的CMakeLists.txt，先让CMake找到完整的Python开发组件，确保pybind11使用正确的库路径：

cmake_minimum_required(VERSION 3.28)

project(example LANGUAGES CXX)

# 优先查找Python开发组件，确保CMake获取完整的头文件和库信息
find_package(Python REQUIRED COMPONENTS Development)
find_package(pybind11 REQUIRED)

pybind11_add_module(example example.cpp)
# 手动绑定Python库，避免自动关联时遗漏
target_link_libraries(example PRIVATE Python::Python)

3. 配置CMake时手动指定Python根目录 #

如果CMake无法自动探测到Python路径，可在配置阶段直接指定Python安装目录：

# 以Visual Studio 2022 64位为例，替换为你的Python实际安装路径
cmake .. -G "Visual Studio 17 2022" -A x64 -DPython_ROOT_DIR=C:/Python312

注意路径使用正斜杠/或双反斜杠\\，同时确保指定的架构（x64）与Python位数一致（32位Python对应Win32）。

4. 检查32位/64位架构匹配 #

链接错误常出现在架构不匹配的情况：

• 确认Python位数：打开命令行输入python -c "import sys; print(sys.maxsize > 2**32)"，返回True为64位；
• CMake生成项目时指定对应架构（如上述命令的-A x64），或在Visual Studio中切换到对应平台（x64而非Win32）。

5. 手动添加Python库路径到CMake #

如果以上方法无效，可直接在CMakeLists.txt中指定Python的libs目录：

cmake_minimum_required(VERSION 3.28)

project(example LANGUAGES CXX)

find_package(pybind11 REQUIRED)

pybind11_add_module(example example.cpp)
# 替换为你的Python安装路径下的libs文件夹
target_link_directories(example PRIVATE "C:/Python312/libs")

为什么Linux下无此问题？ #

Linux系统中Python的共享库（.so）默认存放在系统标准库路径（如/usr/lib），CMake的FindPython模块可自动探测到；而Windows下的.lib文件路径依赖Python安装位置，若未在CMake的搜索路径中，就会出现链接失败的情况。

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