应优先执行python -m ensurepip --upgrade，因其能底层补全pip和setuptools；常见于最小化Python、虚拟环境缺失或Docker slim镜像等场景，且需注意Python版本与setuptools的兼容性（如Python 3.6需setuptools
这是 Python 基础环境缺失核心组件，不是 pip 命令写错了，也不是网络问题——setuptools 没装或版本不匹配，pip 就根本动不了。
为什么 pip install 会直接报这个错
因为 pip install 在处理源码包（.tar.gz）或含 pyproject.toml 的新式包时，必须调用 setuptools.build_meta；如果连 setuptools 这个模块都 import 不出来，pip 就会在第一行就崩溃。常见于：
• 最小化安装的 Python（如某些 Linux 发行版自带的 python3-minimal）
• 手动编译 Python 时没启用 ssl/ensurepip
• 虚拟环境创建时底层 Python 本身就没 setuptools
• macOS 系统自带 Python（已弃用，但仍有残留）
python -m ensurepip --upgrade 是首选方案
它比 pip install setuptools 更底层、更可靠，能同时补全 pip 和 setuptools，且不依赖已有 pip 是否可用：
• 直接运行 python -m ensurepip --upgrade（推荐）
• 若提示权限错误，加 --user： python -m ensurepip --upgrade --user
• Windows 用户若报“拒绝访问”，右键终端选“以管理员身份运行”
• 注意：该命令在 Python 3.4+ 均有效，但 Python 3.12+ 已默认禁用 ensurepip，此时需改用 python -m pip install --upgrade setuptools
虚拟环境里报错，别在全局修
激活虚拟环境后，pip 和 python 指向的是 venv 内部路径，但新创建的 venv 可能继承了宿主 Python 的缺陷（比如没 setuptools）：
• 先确认： python -c "import setuptools; print(setuptools.__version__)"
• 若报错，不要跑出去装全局版，就在当前 venv 里执行 python -m ensurepip（不加 --upgrade，避免覆盖 venv 自带 pip）
• 如果仍失败，说明 venv 创建时底层 Python 就不完整，建议删掉重建：python -m venv --clear myenv，再激活并重试
离线环境或旧系统要盯住版本兼容性
setuptools 60.0+ 要求 Python 3.7+，而很多嵌入式设备或老旧 CI 环境还跑着 Python 3.6 或 2.7：
• 查当前 Python 版本：python --version
• 查可用 setuptools 版本范围：Python 3.6 → 用 setuptools；Python 2.7 → 最高只支持 setuptools==44.1.1
• 离线安装时，去 PyPI setuptools 页面 下载对应 .whl 文件（注意匹配 Python 版本和平台，如 cp36 表示 CPython 3.6），然后 pip install ./setuptools-57.5.0-py3-none-any.whl
• 别用 setup.py install —— 它已弃用，且在无 setuptools 时必然循环报错
最容易被忽略的一点：有些 Docker 镜像（如 python:slim）或 Alpine 环境默认不带 setuptools，但 pip --version 却能成功显示——这说明 pip 是有的，只是无法安装源码包。这时候光升级 pip 没用，必须显式补上 setuptools，否则一碰 numpy、pandas 或飞桨（paddlepaddle）就跪。
