requirements.txt 文件是 pip 用来指定项目依赖包的文件。它列出了所有需要安装的包及其版本。每一行对应一个依赖包,并可以选择性地指定包的版本。

基本格式

  1. 简单列出包名

    1
    package_name
  2. 指定版本

    1
    package_name==1.2.3
  3. 版本比较符号

  • ==:指定特定版本。
  • >=:指定最低版本。
  • <=:指定最高版本。
  • !=:排除特定版本。
  • ~=:指定兼容版本(一般为次要版本更新)。

例如:

1
2
3
4
package_name>=1.2.0
package_name<=2.0.0
package_name!=1.4.0
package_name~=1.4.5
  1. 附加信息
    包可以有额外的安装选项或 URL 来源。

例如:

1
2
package_name[extra]==1.2.3
git+https://github.com/user/repo.git#egg=package_name

示例 requirements.txt

下面是一个示例 requirements.txt 文件:

1
2
3
4
5
6
7
requests==2.24.0
numpy>=1.19.2
pandas~=1.1.3
scipy<=1.5.2
matplotlib
# 下面是一个从 GitHub 安装的包
git+https://github.com/user/repo.git#egg=package_name

创建和使用 requirements.txt

创建 requirements.txt

要生成当前环境的 requirements.txt 文件,可以使用以下命令:

1
pip freeze > requirements.txt

使用 requirements.txt 安装依赖包

要根据 requirements.txt 文件安装依赖包,可以使用以下命令:

1
pip install -r requirements.txt

这样,pip 会读取 requirements.txt 文件,并安装文件中列出的所有包及其指定版本。