如何更新 requirements.txt

当你的 Python 项目使用了多个第三方库时，需要在代码库中维护一个 requirements.txt 文件，记录项目所依赖的库及其版本号。这样，其他人克隆你的项目时，只需要一行命令便可以自动安装所需要的第三方库。

本文将介绍如何更新 requirements.txt 文件，以保持项目依赖库的最新版本。

查看已安装的库及其版本号

在更新 requirements.txt 时，首先需要查看当前已安装的库及其版本号。可以通过 pip 命令执行以下操作：

pip freeze

执行上述命令后，控制台输出所有已安装的库及其版本号，以逐行方式显示:

library1==1.0.0
library2==2.0.0
library3==3.0.0

更新 requirements.txt

在更新 requirements.txt 之前，先将当前文件备份。可以使用以下命令在当前目录下创建一个名为 requirements_old.txt 的备份文件：

cp requirements.txt requirements_old.txt

接下来，打开 requirements.txt 文件，并根据 pip freeze 命令的输出信息手动修改依赖库的版本号。

例如，要升级 library1 库的版本，将它的版本号从 1.0.0 改为 1.1.0，并将该行文本添加到 requirements.txt 文件中。修改后的 requirements.txt 文件应该类似于：

library1==1.1.0
library2==2.0.0
library3==3.0.0

保存文件后，使用以下命令来自动安装所有更新的库版本：

pip install -r requirements.txt

这将升级项目所依赖的库到最新版本。

自动更新 requirements.txt

手动更新 requirements.txt 文件是一种有效的方法，但它需要开发者手动更新库的版本号，耗费时间且容易出错。

幸运的是，有一些工具可以自动检测和更新项目所依赖的库版本。其中最受欢迎的工具之一是 pip-tools。

安装 pip-tools

要使用 pip-tools，用户首先需要安装它。可以通过以下方式来安装 pip-tools：

pip install pip-tools

使用 pip-compile 更新 requirements.txt

一旦安装了 pip-tools，就可以使用 pip-compile 命令自动更新 requirements.txt 文件。pip-compile 命令会从项目的 requirements.in 文件中读取依赖库列表，并在检测到新版本时自动升级版本号。

要使用 pip-compile 命令，需要先创建一个 requirements.in 文件，将所有依赖库名称写入其中：

library1
library2
library3

接下来，在命令行中执行以下命令：

pip-compile

这将生成一个包含所有依赖库和它们的最新版本号的 requirements.txt 文件。注意，pip-compile 可能会升级某些库的主要版本号，这可能需要进一步测试和修改。

结论

维护一个准确的 requirements.txt 文件需要一定的努力，但是通过使用 pip 命令、手动编辑或自动更新工具，可以轻松更新项目的依赖库版本。在为 Python 项目创建 requirements.txt 文件时，请务必遵循最佳实践，并尝试使用自动化工具，以减少输入错误和减轻工作量。