如何在没有网络的生产环境下安装Python库_通过离线wheel包批量安装-Python教程-PHP中文网

生产环境最稳妥的离线安装方式是pip install --no-index --find-links ./wheels -r requirements.txt：它跳过编译、禁用网络、按依赖顺序精准安装，需确保.whl文件平台标签（如cp39-manylinux_x86_64）与目标环境完全匹配，并通过import和文件存在性验证实际可用性。

如何在没有网络的生产环境下安装python库_通过离线wheel包批量安装

pip install 批量安装离线 .whl 包是生产环境最稳妥的做法——它跳过编译、不触发网络请求、依赖关系明确可控。只要 wheel 文件齐全且平台兼容，一次命令就能完成全部安装。

确认目标环境 Python 版本和平台标签

离线安装失败的头号原因是 wheel 文件与目标机器不匹配。不是“Python 3.9”就行，而是必须严格对应：cp39-win_amd64、cp311-manylinux2014_x86_64、py3-none-any 这类标签缺一不可。

在目标离线机上运行：python -c "import platform; print(platform.machine(), platform.system())" 查看架构（如 AMD64 / x86_64）和系统（Windows / Linux）
运行：python -c "import sys; print(f'cp{sys.version_info.major}{sys.version_info.minor}')" 获取 ABI 标签（如 cp39）
运行：python -c "import pip._vendor.packaging.tags; print(list(pip._vendor.packaging.tags.sys_tags())[0])" 直接输出完整兼容标签（最准）

下载时务必用带完整标签的 .whl，比如 requests-2.31.0-py3-none-any.whl（纯 Python）或 numpy-1.26.4-cp39-cp39-win_amd64.whl（Windows 专用）。混用 cp39 和 cp310 的 wheel 会导致 ERROR: Package 'xxx' requires a different Python: xxx

用 `pip download --no-deps` + `--platform` 精准拉取 wheel

在联网机器上，别只用 pip download requests——它默认按当前环境下载，很可能拉回不兼容的包。

先下载主包（不带依赖）：pip download --no-deps --platform manylinux2014_x86_64 --python-version 39 --abi cp39 --only-binary=:all: requests==2.31.0 -d ./wheels
再逐个补依赖（查 pip show requests 得知依赖项），对每个依赖重复上一步，确保所有 .whl 都打上相同 --platform 和 --python-version
最后检查：ls ./wheels | grep -E "(cp39|manylinux)"，确认无 cp310 或 win32 混入

这样生成的 wheels/ 目录，才是可直接扔进离线机使用的干净集合。

testing-python

使用pytest编写和评估有效的Python测试。适用于编写测试、审查测试代码、调试测试失败或提高测试覆盖率。

下载

`pip install *.whl` 不可靠，改用 `--find-links` + `--no-index`

直接 pip install *.whl 看似简单，但存在两个隐患：

安装顺序错乱：若 a.whl 依赖 b.whl，而 b.whl 尚未安装，pip 可能报 ERROR: Could not find a version that satisfies the requirement b（即使文件就在当前目录）
误触网络：某些旧版 pip（

正确做法是：

pip install --no-index --find-links ./wheels -r requirements.txt

其中 requirements.txt 列出你要装的包名（不带版本或路径），例如：

requests==2.31.0
urllib3==1.26.18
certifi==2023.7.22

--find-links 让 pip 扫描本地目录找匹配 wheel，--no-index 彻底禁用远程索引——这才是生产环境该用的组合。

验证安装结果，别只信 “Successfully installed”

安装命令返回成功不代表库真能用。尤其在离线环境，必须手动验证运行时行为：

进入 Python 解释器，逐个 import：python -c "import requests; print(requests.<strong>version</strong>)"
检查 C 扩展是否加载成功（如 numpy、pandas）：python -c "import numpy; numpy.test()"（部分会跳过，但至少不抛 ImportError）
对含二进制依赖的包（如 psycopg2），确认 DLL / so 文件已解压到 site-packages 下对应子目录（psycopg2/_psycopg.cp39-win_amd64.pyd）

最容易被忽略的是：wheel 里带 data files（如证书、模板、配置）的包（certifi、jinja2），它们的文件可能没被复制到正确位置。这时要检查 site-packages/certifi/cacert.pem 是否存在——缺失会导致 HTTPS 请求直接失败，错误信息却只显示 SSLError，跟网络无关。