Cython无法将C动态数组转换为Python对象的问题求助

环境与问题 #

当前环境：Ubuntu 24.04、Python 3.12、Cython 3.0、gcc 13.2
现有C树结构模块仅提供头文件（假设为tree.h）和.so库，C侧逻辑正常。使用Cython对接时出现两处编译错误：

• Node类的children属性无法将C的node*转为Python对象
• process_file函数返回的node*无法转为Python对象

解决方案 #

1. 修正Cython声明文件（cfile.pxd） #

正确声明C结构体与函数，关联外部头文件：

# cfile.pxd
cdef extern from "tree.h":
    ctypedef struct node:
        # 按实际C头文件补充字段，示例如下
        char* name
        int node_type
        node** children  # 假设为NULL结尾的指针数组，链表结构需调整

    node* process_file(const char* filename)

2. 编写Cython包装实现（pyfile.pyx） #

将C的node*封装为Python扩展类型，处理children的转换：

# pyfile.pyx
cimport cfile

# 包装C Node的Python扩展类
cdef class Node:
    cdef cfile.node* c_node  # 存储C侧节点指针

    def __cinit__(self, cfile.node* c_node):
        self.c_node = c_node

    @property
    def name(self):
        return self.c_node.name.decode('utf-8')  # C字符串转Python字符串

    @property
    def node_type(self):
        return self.c_node.node_type

    @property
    def children(self):
        # 遍历C侧children数组，转为Python Node对象列表
        cdef cfile.node** child_ptr = self.c_node.children
        cdef list py_children = []
        if child_ptr is not NULL:
            while child_ptr[0] is not NULL:
                py_children.append(Node(child_ptr[0]))
                child_ptr += 1
        return py_children

# 包装process_file函数，返回Python Node对象
def process_file(str filename):
    cdef cfile.node* root_node = cfile.process_file(filename.encode('utf-8'))
    if root_node is NULL:
        raise ValueError("处理文件失败")
    return Node(root_node)

3. 确认setup.py配置 #

确保正确链接现有.so库，无需重新编译C代码：

from setuptools import setup, Extension
from Cython.Build import cythonize

ext_modules = [
    Extension(
        "pyfile",
        sources=["pyfile.pyx"],
        libraries=["tree"],  # 对应libtree.so，去掉前缀lib与后缀.so
        library_dirs=["."],  # .so文件所在目录，按需修改
        include_dirs=["."],  # 头文件tree.h所在目录，按需修改
    )
]

setup(
    name="tree_wrapper",
    ext_modules=cythonize(ext_modules, compiler_directives={"language_level": "3"})
)

编译与测试 #

执行编译命令：

python setup.py build_ext --inplace

Python中验证：

import pyfile
root = pyfile.process_file("test.txt")
print(root.name)
print([child.name for child in root.children])

关键注意点 #

• 必须通过cdef class封装C指针，避免直接将C类型暴露给Python
• 若C侧children是链表结构，需调整遍历逻辑（比如通过child.next访问下一个节点）
• setup.py需正确指定库路径与头文件路径，确保编译时能找到外部.so库

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