无网络环境下基于python:latest镜像规范构建Python3包的疑问

背景环境 #

使用python:latest Docker镜像（Python 3.11.4），预装依赖：

root@dd8e38ac55dd:/# pip list
Package    Version
---------- -------
pip        23.1.2
setuptools 65.5.1
wheel      0.41.1

需基于pyproject.toml构建纯Python包，配置如下：

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

遇到的问题：

• 联网时pip wheel可正常构建，但气隙环境下加--no-index会报错找不到setuptools（尽管本地已安装）
• 疑惑为何setuptools自身不包含构建工具，是否必须用弃用的setup.py才能无额外依赖构建

问题原因 #

pip默认启用构建隔离机制：构建时会创建一个独立的虚拟环境，从PyPI下载满足build-system.requires的依赖，即使本地环境已安装对应包。这就是气隙环境下报错的核心原因——隔离环境无法下载setuptools。

而setuptools作为PEP 517定义的构建后端，负责实际的包构建逻辑；pip wheel或PyPA的build属于构建前端，负责协调构建环境、调用后端。两者职责分离是PEP规范的设计，所以setuptools本身不包含前端工具。

官方支持的无额外依赖构建方法 #

无需安装PyPA的build工具，也不用退回到弃用的setup.py，只需给pip wheel添加--no-build-isolation参数，强制使用当前环境的setuptools构建：

pip wheel --no-build-isolation --no-index .

这个参数会跳过隔离环境创建，直接复用本地已安装的setuptools和wheel，完全适配气隙环境的需求，且符合PEP 517/518的规范。

补充说明 #

• 如果你的pyproject.toml中build-system.requires包含其他依赖（比如setuptools>=60），需要确保本地环境已安装对应版本，否则构建仍会失败
• 该方法是pip官方文档明确支持的，属于规范的构建方式，无需自行编写构建逻辑

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