VS2017中C++调用Python脚本导入numpy.core.multiarray报错求助

我之前在做类似的C调用Python项目时也碰到过完全一样的报错，这个问题本质上是**C程序运行时的Python环境和VS交互式Python环境不一致**导致的——VS交互环境能正确找到numpy的依赖，但C++进程加载的Python路径或依赖库路径不对，下面是我亲测有效的几个解决步骤：

1. 确保C++使用的Python环境和VS交互环境完全匹配 #

首先得确认两个环境用的是同一个Python版本：

• 打开VS的交互式Python，执行以下命令：

  import sys
  print(sys.executable)  # 记下Python解释器路径，比如C:\Python36\python.exe
  import numpy
  print(numpy.__file__)  # 记下numpy的安装路径，比如C:\Python36\Lib\site-packages\numpy
  

• 然后在你的CMakeLists.txt里明确指定这个Python版本的路径，避免CMake自动找到其他版本：

  # 精确指定Python3.6版本
  find_package(Python3 3.6 EXACT REQUIRED COMPONENTS Interpreter Development)
  # 添加Python头文件目录
  include_directories(${Python3_INCLUDE_DIRS})
  # 添加Python库目录
  link_directories(${Python3_LIBRARY_DIRS})
  # 链接Python库到你的目标程序
  target_link_libraries(你的项目名称 ${Python3_LIBRARIES})
  

  注意必须是x64版本的Python，因为你是用x64-Debug模式构建的C++程序，32位Python会导致不兼容。

2. 配置运行时的环境变量 #

C++程序运行时需要能找到Python的DLL和numpy的核心库，最简单的方式是在VS的调试配置里添加环境变量：

• 右键你的C++项目 → 属性 → 调试 → 环境
• 添加以下内容（替换成你自己的Python路径）：

  PATH=C:\Python36;C:\Python36\DLLs;C:\Python36\Lib\site-packages\numpy\core\lib;%PATH%
  

  或者你也可以在C++代码初始化Python之前手动设置环境变量：

  #include <cstdlib>
  int main() {
      // 设置PATH，确保Python和numpy的依赖能被找到
      _putenv_s("PATH", "C:\\Python36;C:\\Python36\\DLLs;C:\\Python36\\Lib\\site-packages\\numpy\\core\\lib;%PATH%");
      // 初始化Python
      Py_Initialize();
      // 后续调用Python脚本的代码...
      Py_Finalize();
      return 0;
  }
  

3. 重新安装numpy确保完整性 #

虽然VS交互环境能导入numpy，但有可能C++进程访问的是另一个损坏的numpy副本，建议重新安装一次：

• 打开命令提示符，激活你的Python环境（如果用虚拟环境的话），执行：

  pip uninstall -y numpy
  pip install numpy==1.12.0
  

• 安装完成后，在Python里执行numpy.test()确认numpy本身没有损坏。

4. 匹配Debug/Release模式的Python库 #

Python的Debug和Release库是分开的，如果你用x64-Debug模式构建C++程序，最好链接Python的Debug库：

• 在CMakeLists.txt里添加条件判断：

  if(CMAKE_BUILD_TYPE STREQUAL "Debug")
      # 找到Python36的Debug库
      find_library(PYTHON_DEBUG_LIB python36_d PATHS ${Python3_LIBRARY_DIRS})
      target_link_libraries(你的项目名称 ${PYTHON_DEBUG_LIB})
  else()
      target_link_libraries(你的项目名称 ${Python3_LIBRARIES})
  endif()
  

  注意：如果你的Python是从官方下载的，Debug库可能需要单独安装，或者有些版本默认不带，这种情况下用Release库也能勉强运行，但尽量保持模式一致避免奇怪问题。

5. 手动添加numpy的路径到Python的sys.path #

如果上面的步骤都没用，可以在C++代码里手动把numpy所在的site-packages目录添加到Python的搜索路径：

Py_Initialize();
// 获取sys模块
PyObject* sys_module = PyImport_ImportModule("sys");
// 获取sys.path列表
PyObject* sys_path = PyObject_GetAttrString(sys_module, "path");
// 添加site-packages路径
PyList_Append(sys_path, PyUnicode_FromString("C:\\Python36\\Lib\\site-packages"));
// 释放对象避免内存泄漏
Py_DECREF(sys_path);
Py_DECREF(sys_module);
// 现在再导入你的Python脚本
PyObject* script_module = PyImport_ImportModule("你的脚本名称");

这些步骤应该能解决你遇到的numpy导入失败问题，核心就是保证C++进程的Python环境和VS交互环境完全一致，路径都正确。

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