Skip to content

Build Configuration#

pdm 使用 PEP 517 来构建软件包。它充当构建前端,调用构建后端来从任意源树构建源分发和轮子。

构建后端是驱动构建系统从任意源树构建源分发和轮子的组件。

如果运行 pdm init,PDM 将让您选择要使用的构建后端。与其他包管理器不同,PDM 不会强迫您使用特定的构建后端。您可以选择您喜欢的构建后端。以下是 PDM 最初支持的构建后端及相应的配置列表:

pyproject.toml configuration:

1
2
3
[build-system]
requires = ["pdm-backend"]
build-backend = "pdm.backend"

📖 阅读文档

pyproject.toml configuration:

1
2
3
[build-system]
requires = ["setuptools", "wheel"]
build-backend = "setuptools.build_meta"

📖 阅读文档

pyproject.toml configuration:

1
2
3
[build-system]
requires = ["flit_core >=3.2,<4"]
build-backend = "flit_core.buildapi"

📖 阅读文档

pyproject.toml configuration:

1
2
3
[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

📖 阅读文档

pyproject.toml configuration:

1
2
3
[build-system]
requires = ["maturin>=1.4,<2.0"]
build-backend = "maturin"

📖 阅读文档

除了上述提到的后端之外,您还可以使用任何支持 PEP 621 的其他后端,但是 poetry-core 不受支持,因为它不支持读取 PEP 621 元数据。

Info

如果您使用的是不在上述列表中的自定义构建后端,PDM 将处理相对路径为 PDM 样式 (${PROJECT_ROOT} 变量)。