如何使用 pip 安装 pyproject.toml 文件中的依赖包？

在Python项目开发中，pyproject.toml已经成为主流的项目配置文件，用来声明项目元数据、构建要求和依赖信息。很多开发者拿到包含pyproject.toml的项目后，不知道如何快速安装其中列出的所有依赖包，其实pip已经原生支持这类操作，不需要额外的工具。

前置条件

要使用pip安装pyproject.toml中的依赖，首先需要保证你的pip版本足够新，建议升级到21.3及以上版本，旧版本可能不支持对pyproject.toml的完整解析。可以通过以下命令升级pip：

# 升级pip到最新版本
pip install --upgrade pip

基础安装方法

如果你的pyproject.toml文件在当前项目根目录下，直接使用以下命令就可以安装文件中声明的所有依赖：

# 安装当前目录项目的所有依赖
pip install .

这个命令会让pip读取当前目录下的pyproject.toml，解析其中的依赖项，自动下载并安装所有需要的包。如果项目有构建步骤，pip也会先完成项目构建再处理依赖。

可编辑模式安装

如果你是在本地开发项目，希望修改代码后不需要重新安装就能生效，可以使用可编辑模式安装，命令如下：

# 可编辑模式安装本地项目依赖
pip install -e .

加上-e参数后，pip会把项目以可编辑的方式链接到Python环境中，项目代码的修改会实时生效，同时也会安装pyproject.toml中声明的所有依赖。

仅安装依赖不安装项目本身

有些情况下你可能只需要安装依赖，不需要安装项目包本身，这时候可以用以下方式：

# 使用pip的requirements功能导出依赖后安装
pip install -e ".[dev]" --no-deps
# 或者直接解析pyproject.toml中的依赖项（需要pip 23.0+）
pip install -r <(pip show --no-index . | grep Requires | cut -d: -f2 | tr ',' '\n')

不过更推荐的方式是项目维护者在pyproject.toml中规范声明依赖，避免手动解析带来的问题。

常见问题说明

• 如果安装时提示找不到pyproject.toml，需要确认命令执行目录是否正确，必须切换到包含该文件的目录再执行命令。
• 如果依赖安装失败，可以检查pyproject.toml中依赖的版本约束是否合理，是否存在不兼容的版本要求。
• 如果项目使用了非标准的依赖声明方式，可能需要先安装构建后端工具，比如setuptools、poetry-core等，再执行安装命令。

验证安装结果

安装完成后，可以通过以下命令验证依赖是否安装成功：

# 查看当前环境已安装的包
pip list
# 或者检查特定依赖是否存在
pip show 依赖包名

如果能在输出中看到pyproject.toml中声明的依赖包，就说明安装成功了。

pippyproject.tomlPython依赖管理包安装修改时间：2026-05-28 21:36:51