如何使用pip下载Python离线依赖包？

Question

**如何使用pip下载Python离线依赖包？** 在无网络环境中安装Python依赖包时，可以先在有网的机器上使用`pip download`命令将包及其依赖下载到本地目录。例如：`pip download -d ./packages requests`，该命令会将`requests`及其所有依赖包下载到`./packages`目录中。之后，将这些包复制到目标机器，并运行`pip install --no-index -f ./packages package_name`进行本地安装。此方法适用于需要在隔离环境中部署Python应用的场景。

Answer 1

一、问题背景与应用场景

在企业级开发或安全隔离的生产环境中，Python应用常常需要部署在无法访问公网的机器上。这种情况下，常规的pip install package_name方式将无法使用。

为了解决这一问题，可以借助有网络连接的开发机或构建服务器，预先下载所需的依赖包及其依赖项，再将其复制到目标机器进行本地安装。

这正是pip download命令的设计初衷：用于离线环境下的依赖打包。

二、基本操作流程

1. 在联网环境中创建一个目录用于存放依赖包，例如：mkdir ./packages
2. 使用pip download命令下载指定包及其所有依赖：

   pip download -d ./packages requests

3. 将整个./packages目录压缩并传输至目标离线机器
4. 在目标机器上执行以下命令进行离线安装：

   pip install --no-index -f ./packages requests

三、深入解析 pip download 命令

pip download不仅会下载主包，还会递归地下载其所有依赖，并确保版本兼容性。

常用参数说明：

参数	作用
-d 或 --dest	指定下载的目标目录
--platform	指定目标平台（如 win_amd64）
--python-version	指定目标Python版本（如 39 表示 Python 3.9）
--only-binary=:all:	强制只下载wheel文件，不包含源码包

四、进阶技巧与注意事项

• 如果目标环境和下载环境的操作系统或Python版本不同，需使用--platform和--python-version指定目标平台信息
• 对于某些C扩展包（如numpy, psycopg2），建议直接下载对应平台的wheel文件，避免编译失败
• 可结合requirements.txt批量下载依赖包：

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

• 为了保证依赖一致性，建议使用虚拟环境生成requirements.txt后再进行下载

五、完整工作流图解

以下是整个离线依赖包下载与安装的工作流程图：

graph TD
    A[准备联网环境] --> B(创建本地存储目录)
    B --> C{是否已有requirements.txt?}
    C -->|是| D[执行 pip download -r requirements.txt]
    C -->|否| E[手动列出依赖包]
    E --> F[执行 pip download 包名]
    F --> G[打包并传输到离线环境]
    D --> G
    G --> H[解压并进入目录]
    H --> I[执行 pip install --no-index -f packages 包名]
    I --> J[完成安装]