← 全部指南

pyproject.toml 概览

现代 Python pyproject.toml 里,项目元数据与工具表如何摆放。

[project]

PEP 621 通常需要 name 与 version(或声明 dynamic)。dependencies 是需求字符串数组。可选依赖组在 [project.optional-dependencies]。

[tool.*]

工具配置放在 [tool.name] 下。Ruff 常用 line-length、target-version,以及 lint / format 子表。不同工具请分表存放。

用 Schema 检查

在 Schema 工具里选 pyproject 或 Ruff 预设,尽早发现缺 name/version 或缺少 tool.ruff。

用内置预设校验一份 pyproject 样例。

打开 Schema