使用Pybind11导出C全局变量至Python时遇问题求助

我之前也碰到过完全一样的问题！编译的时候顺顺利利，一到Python里调用就报错，核心问题其实是C和C++的链接兼容性，加上pybind11对C全局变量的导出方式没处理到位。咱们一步步来解决：

第一步：先重现你的错误场景（假设你的代码是这样的） #

先把你提到的三个文件的常见错误写法列出来，方便对照：

global.h #

#ifndef GLOBAL_H
#define GLOBAL_H

extern int my_array[5];

#endif

global.c #

#include "global.h"

int my_array[5] = {1, 2, 3, 4, 5};

pyglobal.cpp（错误写法） #

#include <pybind11/pybind11.h>
#include "global.h"

namespace py = pybind11;

PYBIND11_MODULE(pyglobal, m) {
    m.attr("my_array") = py::cast(my_array);
}

这个写法编译能通过，但Python里执行import pyglobal会直接报错——原因是C的全局变量在C里被当作C符号处理，链接时虽然能找到，但pybind11直接cast数组指针的话，Python无法正确识别数组的长度和内存布局，进而引发访问错误。

第二步：正确的解决方案 #

要搞定这个问题，需要两个关键操作：

1. 在C++代码中用extern "C"声明C全局变量，确保链接属性符合C的规则
2. 用pybind11的py::array包装C数组，而不是直接转换指针

修正后的pyglobal.cpp #

#include <pybind11/pybind11.h>
#include <pybind11/numpy.h>
#include "global.h"

namespace py = pybind11;

// 声明C全局变量的C链接属性，避免C++名字修饰导致的问题
extern "C" {
    extern int my_array[5];
}

PYBIND11_MODULE(pyglobal, m) {
    // 用py::array_t包装C数组，明确告诉Python数组的类型、形状和内存信息
    m.attr("my_array") = py::array_t<int>(
        {5},          // 数组的形状（这里是长度为5的一维数组）
        {sizeof(int)}, // 每个元素的字节步长
        my_array       // 指向C数组的指针
    );
}

为什么要这么做？ #

• extern "C"：C和C的名字修饰规则不同，不加这个的话，C编译器会把my_array改成C++风格的符号，虽然编译时能找到，但运行时容易出现未定义行为。
• py::array_t：直接cast数组指针的话，pybind11无法告知Python数组的长度和类型，Python拿到的只是一个裸指针，无法安全当作数组使用。用py::array_t可以明确描述数组的内存布局，让Python能正确访问。

第三步：CMakeLists.txt的正确配置 #

确保你的CMakeLists.txt正确处理C和C++文件的编译链接：

cmake_minimum_required(VERSION 3.14)
project(pyglobal)

# 找到Python和pybind11依赖
find_package(Python3 REQUIRED COMPONENTS Interpreter Development)
find_package(pybind11 REQUIRED)

# 编译C文件为静态库
add_library(global STATIC global.c)

# 生成Python模块并链接C静态库
pybind11_add_module(pyglobal pyglobal.cpp)
target_link_libraries(pyglobal PRIVATE global)

第四步：测试验证 #

编译安装后，打开Python Shell测试：

import pyglobal

print(pyglobal.my_array)
# 输出: [1 2 3 4 5]
print(pyglobal.my_array[0])
# 输出: 1

这样就能正常访问C的全局数组了！

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