需求说明符

Pip 支持使用 需求说明符 从软件包索引安装。一般来说，需求说明符由项目名称后跟可选的 版本说明符 组成。

PEP 508 包含对需求格式的完整规范。

版本 6.0 中添加: 支持环境标记。

版本 19.1 中添加: 支持直接 URL 引用形式。

概述

需求说明符有两种形式

• 基于名称，它由以下组成

  • 一个软件包名称（例如：requests）

  • 可选地，一组“附加”用于安装可选依赖项（例如：security）

  • 可选地，对软件包版本应用的约束

  • 可选地，环境标记

• 基于 URL，它由以下组成

  • 一个软件包名称（例如：requests）

  • 可选地，一组“附加”用于安装可选依赖项（例如：security）

  • 软件包的 URL

  • 可选地，环境标记

示例

一些基于名称的示例需求说明符

SomeProject
SomeProject == 1.3
SomeProject >= 1.2, < 2.0
SomeProject[foo, bar]
SomeProject ~= 1.4.2
SomeProject == 5.4 ; python_version < '3.8'
SomeProject ; sys_platform == 'win32'
requests [security] >= 2.8.1, == 2.8.* ; python_version < "2.7"

注意

在使用 >、< 或使用环境标记时，在 shell 中用引号括住说明符。

在需求文件中，不要 使用引号。只有一个例外：pip v7.0 和 v7.0.1（2015 年 5 月）要求在需求文件中用引号括住包含环境标记的说明符。

一些基于 URL 的示例需求说明符

pip @ https://github.com/pypa/pip/archive/22.0.2.zip
requests [security] @ https://github.com/psf/requests/archive/refs/heads/main.zip ; python_version >= "3.11"