不能直接 pip install *.whl，因其不解析依赖顺序、跳过间接依赖、不校验平台兼容性，易导致安装失败或静默错误。
为什么不能直接 pip install *.whl
直接 pip install *.whl 看似省事，但实际在企业批量部署中极不可靠：它不解析依赖顺序，会跳过间接依赖（比如 requests 依赖 urllib3 和 certifi），也不校验平台兼容性。一旦某个 .whl 文件的标签（如 cp39-win_amd64）和目标机器不一致，安装中途就会报 ERROR: Package 'xxx' requires a different Python 或静默失败。
如何用 --find-links + --no-index 构建可复用的 wheelhouse
核心命令是：pip install --no-index --find-links ./wheelhouse -r requirements.txt。它要求所有依赖（含递归依赖）都提前下载进 ./wheelhouse/ 目录，且全部匹配目标环境。
- 先在联网机上确认目标环境标签：
python -c "import pip._vendor.packaging.tags; print(list(pip._vendor.packaging.tags.sys_tags())[0])"—— 输出类似cp311-cp311-manylinux_2_17_x86_64，这是你后续下载的唯一基准 - 用
pip download精准拉取，必须带--platform、--python-version、--abi和--only-binary=:all:：pip download --no-deps --platform manylinux_2_17_x86_64 --python-version 311 --abi cp311 --only-binary=:all: requests==2.31.0 -d ./wheelhouse - 再对每个依赖项（用
pip show requests查）重复下载，或用pip download --no-deps -r requirements.txt批量获取主包，再逐个补全依赖轮子 - 最终检查：
ls ./wheelhouse | grep -v 'cp311.*manylinux_2_17_x86_64'—— 若有输出，说明混入了不兼容包，必须清理
requirements.txt 必须锁定版本并剔除非二进制依赖
企业离线源最怕“看似装完，运行时报 ImportError”。常见陷阱包括：
-
numpy、pandas等包若写成numpy>=1.24，pip download可能拉回cp310轮子，而你的环境是cp311—— 必须写死版本：numpy==1.24.3 - 避免
pywin32、pycrypto这类只提供源码包（.tar.gz）的库，它们在离线机上无法编译；改用cryptography或pycryptodome等提供完整.whl的替代品 - 删掉
-e .、git+、file://等需要网络或本地路径的行，这些在离线环境下完全失效
验证 wheelhouse 是否真正可用
别跳过这步。在目标离线机上执行：
-
pip install --no-index --find-links ./wheelhouse --dry-run -r requirements.txt—— 加--dry-run可预检是否所有包都能命中，不实际安装 - 挑关键包手动验证：
python -c "import numpy; print(numpy.__version__)"，确认不是“导入成功但运行报错” - 检查
pip list输出是否与requirements.txt完全一致，特别注意setuptools、wheel、pip自身版本 —— 它们也得放进wheelhouse，否则pip install可能因版本太低拒绝安装新轮子
真正的难点不在下载，而在确保整个依赖图里每一个节点的 ABI、平台、Python 版本标签都严丝合缝。少一个 cp311，就可能让整套环境卡在 CI 流水线里。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
