Python 项目依赖离线管理 pip + requirements.txt

背景

项目研发环境不支持联网，无法通过常规 pip install 来安装依赖，此时需要在联网设备下载依赖，然后拷贝到离线设备进行本地安装。

两台设备的操作系统、Python 版本尽可能一致。

离线安装依赖

# 在联网设备上安装项目所需的依赖
# -d 参数指定了存放目录
pip download -d lib requests
pip install --no-index --find-links=lib requests

# 如需使用 requirements.txt 文件
pip download -d lib -r requirements.txt 
pip install --no-index --find-links=lib -r requirements.txt 

requirements.txt

requirements.txt 是 Python 项目中常用的文件，它列出了项目运行所需的第三方库及其版本，通常位于项目的根目录下，其主要作用是帮助自动化安装项目依赖，格式如下：

package_name==version_number
# 示例
requests==2.30.0

有了 requirements.txt 文件，我们就可以使用 pip 来一次性安装所有列出的依赖项。命令如下：

# 这将读取 requirements.txt 文件的内容，并尝试安装其中列出的所有库和版本。
pip install -r requirements.txt

# 如何创建 requirements.txt 呢
pip freeze > requirements.txt

使用 requirements.txt 文件有助于确保项目在不同的环境中有一致的行为，减少因环境差异导致的问题。