如何通过setuptools确保numpy先于依赖包安装以启用其C扩展特性？

可行实现方案 #

1. 利用PEP 517/518构建依赖声明（推荐） #

在你的包根目录下创建pyproject.toml文件，指定构建环境必须先安装numpy：

[build-system]
requires = ["setuptools", "wheel", "numpy"]
build-backend = "setuptools.build_meta"

同时在你的setup.py或setup.cfg的install_requires中，同时添加numpy和目标依赖包：

# setup.py示例
from setuptools import setup

setup(
    name="my_package_name",
    # ...其他配置项
    install_requires=[
        "numpy",
        "your_dependency_package"
    ]
)

原理：pip会先根据pyproject.toml的配置，在独立构建环境中安装numpy，之后再安装你的目标依赖包，此时依赖包的setup.py执行时就能成功import numpy，启用对应的C扩展特性。

2. 临时 workaround：禁用构建隔离（不推荐给普通用户） #

如果用户安装时手动添加参数：

pip install my_package_name --no-build-isolation

pip会跳过独立构建环境，先安装install_requires里的所有依赖（包括numpy），再构建目标依赖包。但这个方法需要用户额外操作，不适合作为默认安装方式。

给依赖包维护者的建议 #

• 改用PEP规范声明构建依赖：在依赖包的pyproject.toml中，将numpy标记为可选构建依赖，配合extras_require实现特性开关。比如：

  # 依赖包的pyproject.toml
  [build-system]
  requires = ["setuptools", "wheel"]
  build-backend = "setuptools.build_meta"
  

  # 依赖包的setup.py
  setup(
      name="your_dependency_package",
      extras_require={
          "numpy": ["numpy>=1.18"]
      },
      # 通过setuptools的条件扩展机制，仅当安装numpy extras时构建对应C扩展
  )
  

  用户只需执行pip install your_dependency_package[numpy]，pip会先安装numpy再构建包，彻底避免手动检查的问题。

• 移除setup.py中的import依赖检查：setup.py执行阶段的环境不代表最终运行环境，依赖检查应该交给包管理工具（如pip）处理。可以通过numpy.get_include()获取头文件路径，若numpy不存在则跳过对应扩展构建，同时明确告知用户需安装numpy以启用特性。

• 发布预构建wheel包：针对主流平台（Windows、macOS、Linux）发布包含numpy特性的预编译wheel，用户安装时直接使用预编译扩展，无需本地构建，从根源解决构建时依赖检查的问题。

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