使用Cython对接Apache Arrow C++时缺失arrow/python/platform.h的解决方法

安全阿岳

2026-7-12

解决Apache Arrow C++ + Cython编译时找不到arrow/python/platform.h的问题

问题根源：arrow/python/platform.h 是Apache Arrow Python绑定（pyarrow）专属的开发头文件，并非系统级Arrow C库的默认安装内容。通过系统包管理器（如apt、yum）安装的Arrow，通常只包含核心C运行时文件，不会附带Python绑定相关的头文件。

解决方案1：利用已安装的pyarrow获取头文件

确保已通过pip安装pyarrow：
```
pip install pyarrow
```

修改setup.py的include_dirs，添加pyarrow的头文件路径。可以通过pyarrow提供的工具函数自动获取路径，无需硬编码：

# distutils: language=c++

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

setup(
    name="cpp_ext",
    ext_modules=cythonize(
        Extension(
            "cpp_ext", ["cpp_ext/module.pyx"],
            extra_compile_args=["-O3"],
            extra_link_args=["-larrow"],
            include_dirs=["/usr/include/arrow", pyarrow.get_include()],
            language="c++",
        ),
    ),
)

pyarrow.get_include()会自动返回pyarrow头文件的安装目录，适配不同环境。

解决方案2：从源码构建完整Arrow开发包
如果需要基于最新源码开发，可手动构建并安装包含Python绑定的Arrow：
1. 克隆Arrow源码仓库：
```
git clone https://github.com/apache/arrow.git
```
2. 创建构建目录并配置CMake（开启Python绑定选项）：
```
cd arrow && mkdir build && cd build
cmake .. -DARROW_PYTHON=ON -DARROW_BUILD_SHARED=ON
```
3. 编译并安装：
```
make -j$(nproc) && sudo make install
```
  完成后，arrow/python/platform.h会被安装到系统默认include目录（通常为/usr/local/include/arrow/python/）。
额外检查：确认你的Cython代码是否真的需要引用arrow/python/platform.h。如果是误引用，可替换为Arrow C++核心库的arrow/platform.h（路径为/usr/include/arrow/platform.h），这样无需依赖pyarrow的头文件。