用途:指导创建、组织并分发可安装的 Python 包,覆盖从项目结构到发布上线的完整流程。
主要能力:介绍源码布局(src/package_name/)与扁平布局两种结构;讲解现代打包标准 PEP 517/518、PEP 621、PEP 660;对比 setuptools、hatchling、flit、poetry 等构建后端;给出 pyproject.toml 的完整配置示例,包括元数据、依赖、可选依赖、classifiers、URL、脚本入口与 entry points;说明 wheel 与源码分发包的构建方式。
使用方式:安装构建与发布工具 pip install build twine,执行 python -m build 生成 dist/ 下的 .tar.gz 与 .whl,用 twine check dist/* 校验,先上传 TestPyPI 验证再发布到 PyPI;可用 API token 与 ~/.pypirc 配置,也可通过 GitHub Actions 在 release 时自动发布。开发期用 pip install -e ".[dev]" 可编辑安装。
适用场景:发布 Python 库、构建带入口的命令行工具、包含数据文件或 C 扩展的包、跨仓库的命名空间包、多架构 wheel 构建、私有包索引分发。
限制:资料未提供具体收费、价格或平台支持信息;示例中的版本号、依赖与配置需按实际项目调整,发布前应在干净环境中验证安装。