VS2022配置matplotlibcpp遇RuntimeError: _ARRAY_API非PyCapsule对象问题

以下是针对该问题的具体修复方案：

• 显式初始化numpy C API
  该错误本质是numpy的C API未正确初始化，需在代码中手动触发初始化流程。修改示例代码如下：

  #include "matplotlibcpp.h"
  #include <Python.h>
  #include <numpy/arrayobject.h>
  
  namespace plt = matplotlibcpp;
  
  int main() {
      Py_Initialize();          // 初始化Python解释器
      import_array();           // 显式初始化numpy C API，必须在Py_Initialize之后调用
  
      plt::plot({1,3,2,4});
      plt::show();
  
      Py_Finalize();            // 清理Python解释器
      return 0;
  }
  

  matplotlibcpp内部依赖numpy，但部分场景下不会主动触发numpy的C API初始化，手动调用import_array()可解决Capsule对象识别失败的问题。

• 匹配numpy与Python版本
  Python3.7仅兼容numpy 1.21.x及更早版本（numpy 1.22+不再支持Python3.7），执行以下命令安装对应版本：

  pip install numpy==1.21.6
  

  同时确保项目链接的numpy库文件（如numpy.lib）与安装的numpy版本完全一致，路径指向Python37\Lib\site-packages\numpy\core\libs。

• 修正项目配置

  • VC++包含目录需添加numpy的头文件路径：Python37\Lib\site-packages\numpy\core\include
  • 链接器附加库目录需添加numpy的库文件路径：Python37\Lib\site-packages\numpy\core\libs
  • 确认项目平台（x86/x64）与Python安装平台完全一致，避免位数不匹配导致的DLL加载异常。

• 验证Python环境加载
  确保系统PATH环境变量中Python37的安装目录优先级最高，避免其他版本的Python DLL被误加载。可通过Process Monitor工具检查进程加载的DLL，确认Python37.dll及numpy相关DLL均来自目标Python37环境。

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