pip download离线升级失败主因是未指定目标环境参数，须用--platform、--python-version、--abi和--only-binary=:all:精准匹配；漏依赖或requires-python校验也会报错，需补全依赖链或--force-reinstall跳过检查。
pip download 怎么指定 Python 版本和平台
离线升级失败，八成卡在 pip download 下载了错架构的包。内网机器可能是 aarch64、win-amd64 或 musllinux，而你本地默认下的是 cp311-cp311-manylinux_x86_64 —— 一装就报 ERROR: xxx.whl is not a supported wheel on this platform。
必须显式告诉 pip 目标环境：--platform、--python-version、--abi、--only-binary=:all: 缺一不可。
-
--platform manylinux2014_x86_64（常见 CentOS 7）或manylinux_2_17_aarch64（国产 ARM 服务器） -
--python-version 39对应 Python 3.9，别写成3.9，pip 只认两位数字 -
--abi cp39（CPython 3.9），若用 PyPy 则为pp39 - 务必加
--only-binary=:all:，否则 pip 仍可能去下.tar.gz源码包，离线环境没法编译
示例命令：
pip download numpy==1.24.4 --platform manylinux2014_x86_64 --python-version 39 --abi cp39 --only-binary=:all: -d ./whls
离线安装时提示“no metadata found”或“requires-python mismatch”
这通常不是包坏了，而是你漏了依赖链里的某个轮子，或者 requires-python 元数据被 pip 严格校验了 —— 尤其在旧版 pip（
立即学习“Python免费学习笔记（深入）”；
安全 Python 代码沙箱：在隔离的沙箱中执行任意 Python 代码，预装 requests、NumPy、pandas 库。返回 stdout、stderr。
根本解法是：下载时带上 --no-deps 分两步走，再用 --find-links 和 --no-index 控制依赖解析路径。
- 先下载主包及其全部依赖：
pip download mypackage --no-deps -d ./whls，再单独跑一遍pip download -r requirements.txt --no-deps -d ./whls - 确保所有
.whl文件都在同一目录（如./whls），然后在目标机执行：pip install --find-links ./whls --no-index --upgrade mypackage - 如果仍有
requires-python报错，检查目标机 Python 版本是否真匹配py39或py3标签；某些包会写Requires-Python: >=3.8,，但 wheel 文件名只标 <code>py3，pip 21.3+ 才能正确识别
requests、setuptools 这类基础包怎么安全离线升级
直接 pip install --upgrade requests 离线运行，极大概率把 pip 自己搞挂 —— 因为 pip 依赖 setuptools 和 packaging，升级过程中模块被替换，后续命令直接抛 ImportError。
必须绕过运行时替换，用 --force-reinstall --no-deps + 完整依赖快照。
- 先在同版本环境中生成完整依赖树：
pip freeze > full-reqs.txt，再用pip download -r full-reqs.txt --no-deps -d ./whls-base - 升级关键包前，先装好它的直接依赖（比如
chardet、idna、urllib3），再装requests本身 - 终极保险操作：
pip install --force-reinstall --no-deps ./whls/requests-2.31.0-py3-none-any.whl，跳过依赖检查，靠人工保证一致性
内网机器没 pip 或 pip 版本太老怎么办
别指望用 get-pip.py 在线装 —— 它默认要连 pypi.org。得提前准备好离线可用的 pip 轮子，并注意 wheel 名称里的 py2.py3-none-any.whl 是纯 Python 实现，兼容性最好。
- 在能联网的同版本 Python 环境中执行：
pip download pip setuptools wheel --no-deps -d ./whls-pip - 找一个
pip-X.Y.Z-py2.py3-none-any.whl（比如pip-23.3.1-py3-none-any.whl），它不绑定 CPython ABI，最稳妥 - 目标机上用 Python 直接安装：
python -m pip install ./whls-pip/pip-23.3.1-py3-none-any.whl，此时 pip 就可用了 - 切记：老系统（如 CentOS 6）可能缺
ssl模块，导致 pip 升级后仍无法验证 HTTPS，这时得同步拷贝certifi包并设环境变量SSL_CERT_FILE
离线升级真正的难点不在命令怎么敲，而在确认每一层 wheel 的平台标签、ABI、Python 兼容范围是否和目标机严丝合缝 —— 差一个字符，就白忙半天。
