Github Actions Python包CI工作流因numpy模块找不到失败

问题根源 #

你的setup.py中直接引用了numpy（比如调用numpy.get_include()获取头文件路径），而当前pip默认采用PEP 517/518的构建流程：执行setup.py前会创建隔离的构建环境，你通过requirements.txt或显式命令安装的numpy不在这个隔离环境内，导致运行setup.py时触发ModuleNotFoundError。

解决方案 #

在项目根目录创建pyproject.toml文件，明确声明构建依赖，让pip在执行setup.py前自动安装numpy：

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

补充说明 #

• 该文件是PEP 517/518规定的标准配置，用于告知pip构建包所需的依赖，这些依赖会在setup.py执行前安装完成。
• 无需修改现有setup.py或requirements.txt的内容，仅需新增此文件即可。
• 可先在本地执行pip install -e .验证问题是否解决，再推送到Github触发Actions测试。

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