Boost.Numpy示例无法运行：复制官方代码出现异常

我经常碰到Boost.Numpy新手遇到这类复制文档代码却跑不通的问题，咱们一步步来排查修复。首先先把你提供的不完整代码补全并格式化：

#include <boost/python.hpp>
#include <boost/python/numpy.hpp>
#include <iostream>

using namespace std;
namespace p = boost::python;
namespace np = boost::python::numpy;

np::ndarray test() {
    int data[] = {1,2,3,4,5};
    p::tuple shape = p::make_tuple(5);
    p::tuple stride = p::make_tuple(sizeof(int)); // 你这里的代码截断了，补全为sizeof(int)
    np::dtype dtype = np::dtype::get_builtin<int>();
    // 构造ndarray，注意内存所有权问题
    return np::from_data(data, dtype, shape, stride, p::object());
}

BOOST_PYTHON_MODULE(example) {
    np::initialize(); // 关键：必须初始化Numpy模块
    p::def("test", test);
}

下面是几个最可能导致运行失败的原因和对应的修复方案：

1. 遗漏Boost.Numpy初始化步骤 #

这是最常见的错误！Boost.Numpy在使用前必须调用np::initialize()，而且要放在BOOST_PYTHON_MODULE函数的最开头。如果没加这行，运行时会直接抛出找不到Numpy API的错误。

2. sizeof(...)语法不完整 #

你提供的代码里sizeof(...明显是截断了，正确的写法是sizeof(int)——因为数组元素是int类型，步长就是单个int的字节数，这是构造ndarray时必须的参数。

3. 编译链接参数不正确 #

编译时必须正确指定Python头文件路径、链接Boost.Python和Boost.Numpy库。比如用g++编译的命令示例（替换成你的Python版本）：

g++ -shared -fPIC -I/usr/include/python3.8 -lboost_python38 -lboost_numpy38 example.cpp -o example.so

注意：Boost库的版本要和Python版本严格匹配，比如Python3.8就要用boost_python38和boost_numpy38，否则会出现链接错误。

4. 内存所有权隐患 #

你当前代码里用栈上的data数组构造ndarray，返回后栈内存会被销毁，Python端访问时会触发野指针错误！更安全的做法有两种：

• 用Boost.Python管理内存：

  int* data = new int[5]{1,2,3,4,5};
  // 让Boost负责释放内存
  return np::from_data(data, dtype, shape, stride, p::object(p::handle<>(p::borrowed(data))));
  

• 直接用Python列表转换（更简单）：

  np::ndarray test() {
      p::list data_list;
      data_list.append(1);
      data_list.append(2);
      data_list.append(3);
      data_list.append(4);
      data_list.append(5);
      return np::array(data_list);
  }
  

测试修复后的代码 #

编译生成example.so后，在Python中测试：

import example
arr = example.test()
print(arr)
print(arr.dtype)

正常情况下会输出：

[1 2 3 4 5]
int32

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