Windows下cppyy加载libcppyy_backend库失败问题求助

问题描述 #

本人是C与cppyy新手，已安装cppyy、cppyy-backend及MS Studio C包，但在Windows系统运行测试代码时，持续出现RuntimeError，提示无法加载libcppyy_backend库，错误详情包含WinError 1114及找不到相关pyd/dll文件，尝试重装包后问题仍未解决。

报错信息：

RuntimeError: could not load cppyy_backend library, details:
[WinError 1114] A dynamic link library (DLL) initialization routine failed
Could not find module 'libcppyy_backend.cp310-win_amd64.pyd' (or one of its dependencies). Try using the full path with constructor syntax.
Could not find module 'C:\Users\danya\AppData\Local\Programs\Python\Python310\lib\site-packages\cppyy_backend\lib\libcppyy_backend.cp310-win_amd64.pyd' (or one of its dependencies). Try using the full path with constructor syntax.
Could not find module 'libcppyy_backend.dll' (or one of its dependencies). Try using the full path with constructor syntax.

测试代码：

import cppyy
cppyy.cppdef(r"""\
void hello() {
    std::cout << "Hello, World!" << std::endl;
}""")
cppyy.gbl.hello()

解决步骤 #

• 确认MSVC版本与Python版本匹配
  你的Python是3.10 64位，需安装对应版本的MS Visual Studio C++工具包：

  • 打开VS Installer选择「修改」，确保勾选「C++桌面开发」组件，且安装的MSVC工具集版本（如MSVC v143）支持Python 3.10（VS2022的v143完全兼容）。
  • 安装完成后重启电脑，确保环境变量生效。

• 排查并修复依赖库缺失
  WinError 1114通常是pyd/dll的依赖项未找到，按以下步骤排查：

  1. 定位报错中的pyd文件路径：C:\Users\danya\AppData\Local\Programs\Python\Python310\lib\site-packages\cppyy_backend\lib\libcppyy_backend.cp310-win_amd64.pyd
  2. 打开x64 Native Tools Command Prompt for VS 2022（必须对应64位架构），运行命令检查依赖：

     dumpbin /dependents "C:\Users\danya\AppData\Local\Programs\Python\Python310\lib\site-packages\cppyy_backend\lib\libcppyy_backend.cp310-win_amd64.pyd"
     

  3. 若输出中有缺失的DLL（如MSVCP140.dll、VCRUNTIME140_1.dll等），从VS工具集目录复制对应文件到Python的Scripts目录，或确保系统System32目录中有对应版本文件。

• 重装指定版本的cppyy包
  版本不兼容可能导致问题，卸载现有包后安装兼容版本：

  pip uninstall -y cppyy cppyy-backend
  pip install cppyy==2.4.0 cppyy-backend==1.14.0
  

  （这两个版本在Python3.10+Windows环境下兼容性较好）

• 手动指定库路径
  在测试代码开头添加以下内容，强制指定pyd文件路径：

  import os
  os.environ['CPPYY_BACKEND_LIBRARY'] = r'C:\Users\danya\AppData\Local\Programs\Python\Python310\lib\site-packages\cppyy_backend\lib\libcppyy_backend.cp310-win_amd64.pyd'
  import cppyy
  # 后续测试代码不变
  

• 确认Python环境无冲突
  确保使用的Python是系统默认或虚拟环境中的干净版本，避免多版本冲突。运行where python确认路径是否正确。

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