如何在无网络环境下本地安装Python项目所需依赖包

一、提前在有网络环境下载所有包及依赖 #

在能正常访问PyPI的机器上，执行以下命令将requirements.txt中列出的所有包（包括间接依赖）下载到指定本地文件夹：

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

• 命令说明：
  • -r requirements.txt：指定依赖清单文件
  • -d ./offline_packages：指定下载后包的存放目录（可自定义路径）
• 注意事项：
  • 需保证下载机器的Python版本、操作系统与目标无网络系统完全一致（比如Windows下下载的包无法在Linux系统使用，Python 3.9的包不适配Python 3.11）
  • 对于带dev标记的包（如enlopy==0.1.dev12），若pip无法直接下载，需手动从其源码仓库下载对应版本的源码包（.tar.gz格式）放入上述目录

二、无网络环境下本地安装 #

1. 将下载好的offline_packages文件夹和requirements.txt文件复制到目标无网络系统的任意路径
2. 打开终端/命令提示符，执行以下命令完成安装：

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

• 命令说明：
  • --no-index：禁止pip从PyPI等远程索引源查找包
  • --find-links=./offline_packages：指定从本地文件夹查找包（路径需与实际存放目录匹配）
• 可选优化：建议在目标系统创建Python虚拟环境后执行安装命令，避免污染全局Python环境

内容的提问来源于stack exchange，提问作者Debayan Paul