Python项目打包演进：从setup.py到pyproject.toml

1. Python打包工具演进背景

现代Python项目打包经历了从distutils到setuptools再到PEP 517/518标准的演进过程。早期setup.py作为项目配置入口存在多年，但随着工具链复杂化，其动态执行特性带来的问题逐渐显现。我在维护多个开源项目时，经常遇到因setup.py中复杂逻辑导致的构建环境污染问题。

2016年提出的PEP 517和PEP 518首次引入了pyproject.toml作为声明式配置文件，将构建依赖与项目元数据分离。这个设计解决了几个关键痛点：

• 构建系统引导问题（先有鸡还是先有蛋）
• 可重现的构建环境
• 元数据的静态可解析性

2. pyproject.toml的核心能力解析

2.1 标准化的项目配置

现代pyproject.toml通常包含这些核心段：

toml复制[build-system]
requires = ["setuptools>=61.0"]
build-backend = "setuptools.build_meta"

[project]
name = "my_package"
version = "0.1.0"
authors = [{name = "John Doe", email = "john@example.com"}]
description = "My awesome package"
readme = "README.md"
requires-python = ">=3.8"
classifiers = [
    "Programming Language :: Python :: 3",
    "License :: OSI Approved :: MIT License",
]

关键优势在于：

• 版本号可以静态定义而不必导入__version__
• 依赖关系声明更清晰规范
• 支持声明式元数据（如作者信息）

2.2 构建系统声明

[build-system]段是pyproject.toml独有的核心功能：

toml复制[build-system]
requires = ["setuptools>=61.0", "wheel"]
build-backend = "setuptools.build_meta