python venv怎么离线安装依赖包-Python教程-PHP中文网

不能离线安装 venv，但可离线安装其依赖包，关键在于必须同时使用 --no-index 和 --find-links 参数；否则 pip 默认联网访问 PyPI，离线时会报“Could not find a version”或连接错误。

python venv怎么离线安装依赖包

直接说结论：不能“离线安装 venv”，但可以离线安装 venv 里的依赖包——关键在 pip install --no-index --find-links 这组参数，缺一不可。

为什么 `pip install -r requirements.txt` 在离线环境会失败

默认情况下，pip install 会尝试连接 PyPI（https://pypi.org/simple）解析并下载每个包及其所有间接依赖。离线机器没有网络，就会卡在 “Could not find a version that satisfies the requirement” 或直接报 ConnectionError。

常见错误现象包括：

ERROR: Could not find a version that satisfies the requirement xxx (from versions: none)
ERROR: No matching distribution found for numpy==1.24.3（尤其在平台/Python 版本不匹配时）
明明有 .whl 文件，却提示 xxx.whl is not a supported wheel on this platform

根本原因不是 pip 本身坏了，而是它没被告知“别上网，本地找”。

`pip download` 必须带平台和 Python 版本参数

在联网机器上执行 pip download 时，如果只写 pip download -r requirements.txt -d packages，很可能下回来一堆不兼容的包——比如 macOS 的 manylinux 轮子被下到 Windows 目录里，或 Python 3.9 的 .whl 被下到 Python 3.11 环境中。

务必显式指定目标环境特征：

--platform win_amd64（Windows 64 位）或 --platform manylinux2014_x86_64（CentOS 7+/Rocky Linux）或 --platform macosx_10_9_x86_64
--python-version 311（对应 Python 3.11；注意是 311 不是 3.11）
--only-binary=:all: 强制只下预编译轮子，避开源码包（.tar.gz）需要编译的问题

完整命令示例（Windows + Python 3.11）：

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

pip download -r requirements.txt -d ./offline_packages \
  --platform win_amd64 \
  --python-version 311 \
  --only-binary=:all:

`pip install` 离线安装时的三个必要条件

在离线机器上激活 venv 后，运行安装命令前，必须同时满足以下三点，否则大概率失败：

--no-index：彻底禁用 PyPI 索引，不许 pip 去网上查任何东西
--find-links 指向包含 .whl 文件的**目录路径**（不是文件路径），且该目录下必须有 index.html 或能被 pip 自动识别为包源（实际只需放好 .whl 即可）
-r requirements.txt 中的包名、版本号，必须与 ./offline_packages/ 下已存在的 .whl 文件名严格匹配（比如 numpy-1.24.3-cp311-cp311-win_amd64.whl 对应 numpy==1.24.3）

正确命令（Linux/macOS 示例）：

source my_venv/bin/activate
pip install --no-index --find-links=./offline_packages -r requirements.txt

Windows 用户注意：--find-links=. 中的点必须是当前工作目录，且需先 cd 进入 offline_packages 所在父目录，否则路径解析易出错。

二进制依赖（如 `numpy`、`pandas`）最容易踩的坑

这类包几乎都含 C 扩展，离线安装失败十次里有八次是因为 wheel 不匹配。核心检查项：

联网机器和离线机器的 python -c "import platform; print(platform.machine())" 输出必须一致（AMD64 vs x86_64 通常可互认，但 ARM64 和 AMD64 绝对不行）
确认离线机器 Python 是 64 位：python -c "import struct; print(struct.calcsize('P') * 8)" 应输出 64
某些包（如 cryptography）在 PyPI 上无 Windows wheel，得去 Gohlke 非官方库手动下载，注意核对 cp311、win_amd64 标签

最省事的做法：在联网机器上用和离线机**完全相同的系统+Python版本**跑一遍 pip install -r requirements.txt，再用 pip download --find-links ~/.cache/pip/wheels -d ./offline_packages -r requirements.txt 复用本地 wheel 缓存，基本不会翻车。