声明依赖

最佳实践是在静态文件中声明依赖项，而不是通过临时安装来修改环境。一旦定义了依赖项，就可以锁定它们，以创建一个一致的、可重现的环境。

使用 pyproject.toml

pyproject.toml 文件是 Python 中用于定义项目配置的标准文件。

在 pyproject.toml 文件中定义项目依赖项

pyproject.toml

[project]
dependencies = [
  "httpx",
  "ruff>=0.3.0"
]

在 pyproject.toml 文件中定义可选依赖项

pyproject.toml

[project.optional-dependencies]
cli = [
  "rich",
  "click",
]

每个键定义一个“extra”，可以使用 --extra 和 --all-extras 标志或 package[<extra>] 语法进行安装。有关更多详细信息，请参阅关于安装软件包的文档。

有关开始使用 pyproject.toml 的更多详细信息，请参阅官方pyproject.toml 指南。

使用 requirements.in

使用轻量级的 requirements.txt 格式来声明项目的依赖项也很常见。每个需求都定义在单独的一行上。通常，此文件称为 requirements.in，以将其与用于锁定依赖项的 requirements.txt 区分开。

在 requirements.in 文件中定义依赖项

requirements.in

httpx
ruff>=0.3.0

此格式不支持可选的依赖项组。