Python 官方打包体系中的构建工具 Setuptools 的官方代码仓库,用于构建和分发 Python 项目。
pypa/wheel
用于查看、解包、重新打包和修改 Python wheel(.whl)文件标签的命令行工具,也可将 egg 转换为 wheel。
- Star
- 580
- Fork
- 200
- 未关闭 Issue
- 22
- 最近提交
- 10天前
这是什么?
wheel 是 PyPA 官方维护的命令行工具,用于处理 PEP 427 定义的 Python wheel 二进制分发格式。wheel 是预先构建好的包归档,pip 安装时无需在用户机器上再执行构建步骤。
该工具支持四类操作:将旧式 .egg 归档转换为 .whl,将 wheel 解包到目录,把修改后的目录重新打包为 wheel,以及为已有 wheel 添加或删除平台和解释器标签。当需要让包适配其他平台或在修改后重新打包时,这些操作很有用。
项目已不再提供 bdist_wheel 构建命令,自 setuptools v70.1 起,setuptools 可自行构建 wheel。只有在需要 wheel 命令行工具时才需要安装本包。
核心功能
- 01将 .egg 归档转换为 .whl 格式
- 02将 wheel 归档解包到目录
- 03将修改后的目录重新打包为 wheel 文件
- 04为已有 wheel 添加或删除标签
适用场景
- 为 wheel 修改标签,使其适配其他平台或 Python 版本
- 在重新分发前查看或修改 wheel 的内容
- 将旧的 egg 分发包迁移为 wheel 格式
使用前须知
- 仅在需要 wheel 命令行工具时才有用,因为 setuptools 构建 wheel 已不再依赖它。
标签
常见问题
- wheel 是什么?
- 用于查看、解包、重新打包和修改 Python wheel(.whl)文件标签的命令行工具,也可将 egg 转换为 wheel。 wheel 是 PyPA 官方维护的命令行工具,用于处理 PEP 427 定义的 Python wheel 二进制分发格式。wheel 是预先构建好的包归档,pip 安装时无需在用户机器上再执行构建步骤。
- wheel 可以免费使用吗?用的什么许可证?
- wheel 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
- wheel 还在维护吗?
- 活跃维护中。wheel 最近一次提交是在 2026年10月28日。
- wheel 适合用来做什么?
- 为 wheel 修改标签,使其适配其他平台或 Python 版本 在重新分发前查看或修改 wheel 的内容 将旧的 egg 分发包迁移为 wheel 格式
- 在哪里获取 wheel?
- 源代码和安装说明在 GitHub 上:https://github.com/pypa/wheel
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
28701452PythonMIT更新于 9天前
用于将 Python 源码包和 wheel 包上传到 PyPI 的命令行工具,不依赖具体的构建系统。
1792348PythonApache-2.0更新于 25天前
用 Rust 编写的极速 Python 包与项目管理工具,可替代 pip、virtualenv、pyenv 等多种工具。
9.2万+339 本周3776RustApache-2.0更新于 10小时前
一款 Python 虚拟环境与依赖管理工具,把 pip 和 virtualenv 整合在一起,通过 Pipfile 和锁文件实现可复现构建。
2.5万+1 本周1887PythonMIT维护活跃更新于 7小时前
Python 官方标准包安装工具,用于从 PyPI 及其他索引安装软件包。
1万+5 本周3435PythonMIT更新于 11小时前
一组命令行工具(pip-compile 与 pip-sync),用于将 Python 依赖锁定为可复现的 requirements 文件,并让虚拟环境与之保持同步。
8003686PythonBSD-3-Clause维护活跃更新于 前天