问题：如何手动下载并本地安装Python依赖包？

Question

在离线或受限网络环境中部署Python项目时，常需手动下载并本地安装依赖包。如何正确下载依赖包及其所有子依赖，并在目标环境中完成安装？

Answer 1

在离线或受限网络环境中部署Python项目：依赖包的下载与安装详解

1. 问题背景与核心挑战

在企业内网、隔离环境或网络受限的部署场景中，Python项目往往无法直接通过 pip install 在线安装依赖包。这种情况下，需要手动下载依赖包及其所有子依赖，并在目标机器上完成安装。

关键挑战包括：

• 如何确保所有依赖包（包括嵌套依赖）都被正确下载？
• 如何避免版本冲突或依赖缺失？
• 如何在无网络环境下安装这些依赖？

2. 依赖分析与收集：从浅入深

第一步是在有网络的环境中分析项目所需的依赖及其子依赖。

1. 使用 pip freeze 获取当前环境依赖列表

2. 适用于项目已有开发环境的情况：

   pip freeze > requirements.txt

3. 使用 pipdeptree 分析依赖树

4. 安装依赖树工具：

   pip install pipdeptree

   生成依赖树：

   pipdeptree > dependency_tree.txt

3. 依赖包的下载方法

下载依赖包需使用 pip download 命令，可递归下载所有依赖。

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

其中：

• -r requirements.txt：指定依赖列表
• --dest ./packages：指定下载目录

命令	用途
pip download	下载包及其依赖，不安装
pip install --no-index	从本地安装，不联网

4. 依赖包的本地安装流程

将下载好的依赖包（包括 .whl 和 .tar.gz 文件）拷贝到目标机器的指定目录，执行安装命令：

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

关键参数说明：

• --no-index：禁用PyPI索引
• --find-links：指定本地依赖包路径

graph TD A[准备requirements.txt] --> B[下载依赖包] B --> C[拷贝到目标环境] C --> D[本地安装]

5. 高级技巧与注意事项

• 跨平台兼容性问题：某些包可能包含平台相关的二进制文件（如 pywin32），需确保下载与目标平台匹配的版本。
• 虚拟环境隔离：推荐在虚拟环境中进行依赖下载与测试，避免污染全局环境。
• 签名验证与安全控制：在高安全要求的环境中，需验证包来源与签名。