首页/开发/CI/CD 与发布速查/Python 分发形态(wheel 与 sdist)
构建与制品管理58 条

Python 分发形态(wheel 与 sdist)

wheel(.whl)是预构建分发、安装快;sdist(.tar.gz)需要目标环境本地构建,易受系统依赖影响。

CI/CD 与发布速查开发更新于 2026-10-12
wheel已构建格式,安装时无需编译(除非纯源码包标注)
sdist源码分发,安装时执行构建步骤
平台标签manylinux 等标签声明兼容的 glibc/平台范围

构建与安装

构建与安装
python -m build   # 生成 dist/*.whl 与 *.tar.gz
pip install dist/app-1.9.0-py3-none-any.whl
内部交付优先提供 wheel:把编译复杂度留在构建流水线,而不是部署机上。

易错点

  • 部署机上从源码安装:缺少编译工具链的机器直接失败,提前构建 wheel
  • wheel 平台标签与目标环境不符:安装被拒或行为异常,核对 manylinux 版本

数据来源与参考

  • PyPA 文档《Python Packaging User Guide》
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌