python pip如何离线安装

在无网络环境下使用 pip 安装 Python 包，通常有以下几种常见方式。

一、提前在有网环境下载包（最常用）

1️⃣ 下载 .whl 或源码包

在有网络的机器上（Python 版本、系统尽量一致）：

pip download 包名 -d ./packages

例如：

pip download requests -d ./packages

可同时下载依赖：

pip download requests -d ./packages --no-deps   # 只下自己
pip download requests -d ./packages             # 包含依赖

指定 Python 版本（可选）：

pip download requests -d ./packages \
  --python-version 39 \
  --only-binary=:all:

2️⃣ 拷贝到离线机器

将 packages 文件夹复制到目标机器（U盘 / 内网传输等）。

3️⃣ 离线安装

在离线机器上：

pip install --no-index --find-links=./packages 包名

或安装整个目录：

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

二、使用 requirements.txt 离线安装（推荐）

有网机器：

pip freeze > requirements.txt
pip download -r requirements.txt -d ./packages

离线机器：

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

三、使用本地 .whl 文件直接安装

如果你已经有 .whl 文件：

pip install package.whl

多个文件：

pip install *.whl

四、使用离线镜像（适合内网大规模部署）

1️⃣ 搭建本地 pip 源（如 pip2pi）

pip install pip2pi

pip2pi /path/to/mirror requests flask

2️⃣ 使用本地源

pip install requests \
  --index-url=file:///path/to/mirror/simple

五、常见问题

❓ 缺少编译环境（如 cryptography）

• 优先下载 预编译 wheel
• 使用：

pip download 包名 --only-binary=:all:

❓ 系统不一致

• Windows / Linux / macOS 的 wheel 不通用
• Python 版本也必须匹配

如果你能告诉我：

• 操作系统
• Python 版本
• 是否允许 U 盘 / 内网
• 要装哪些包

我可以给你更精确的命令。