python -m build为 Python 项目生成源码包（.tar.gz）和 Wheel 包（.whl），用于发布到 PyPI 或分发安装。
前置要求
# 安装 build 工具
pip install build
# 项目需有 pyproject.toml基本用法
# 构建两种包
python -m build
# 仅构建 Wheel
python -m build --wheel
# 仅构建源码包
python -m build --sdist构建结果存放在 dist/ 目录：
my_project-0.1.0.tar.gz（源码包）my_project-0.1.0-py3-none-any.whl（Wheel 包）
pyproject.toml 示例
[build-system]
requires = ["setuptools>=42", "wheel"]
build-backend = "setuptools.build_meta"
[project]
name = "my_project"
version = "0.1.0"
dependencies = ["requests>=2.25.0"]发布到 PyPI
pip install twine
twine upload dist/*本地安装测试
pip install dist/my_project-0.1.0-py3-none-any.whl常见问题
| 问题 | 解决 |
|---|---|
| 缺少 pyproject.toml | 创建配置文件，配置 [build-system] |
| 构建工具未安装 | pip install setuptools wheel |
| 源文件缺失 | 检查 MANIFEST.in 或自动包含规则 |