使用cibuildwheel时python -m build无法找到numpy头文件

以下是几种可靠的解决方式，按推荐程度排序：

1. 用pyproject.toml声明构建依赖（推荐） #

现代Python打包标准要求用pyproject.toml指定构建阶段的依赖，cibuildwheel会自动在构建前安装这些依赖，确保numpy已被正确安装，从而让编译流程能找到其头文件。

在项目根目录创建或修改pyproject.toml：

[build-system]
requires = ["setuptools", "cython", "numpy>=1.21.0"]  # 按需调整numpy版本
build-backend = "setuptools.build_meta"

2. 在setup.py中显式指定numpy的include路径 #

如果仍在使用传统的setup.py，确保在扩展模块配置中加入numpy的include目录，同时声明构建依赖：

from setuptools import setup, Extension
import numpy as np

# 定义你的Cython扩展模块
ext_modules = [
    Extension(
        "your_package.your_module",  # 替换为你的模块路径
        sources=["src/your_package/your_module.pyx"],  # 替换为你的Cython文件路径
        include_dirs=[np.get_include()],
    )
]

setup(
    name="your_package",
    ext_modules=ext_modules,
    setup_requires=["numpy>=1.21.0"],  # 构建前需要安装numpy
    install_requires=["numpy>=1.21.0"],  # 运行时依赖
)

3. 为cibuildwheel显式设置环境变量 #

如果上述方法仍不生效，可以直接在cibuildwheel的配置中指定C_INCLUDE_PATH：

方式一：在pyproject.toml中配置 #

[tool.cibuildwheel.environment]
C_INCLUDE_PATH = "$(python -c 'import numpy; print(numpy.get_include())')"

方式二：命令行指定 #

cibuildwheel --environment C_INCLUDE_PATH="$(python -c 'import numpy; print(numpy.get_include())')"

关键说明 #

本地环境中手动设置C_INCLUDE_PATH能生效，但cibuildwheel是在隔离的虚拟环境/容器中执行构建的，本地环境变量不会被传递进去，因此必须通过上述打包配置或cibuildwheel专属配置来传递路径信息。

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