.whl是pip官方唯一支持的二进制安装格式,.egg自pip 10.0起被彻底移除;其根本原因是设计冲突:egg允许运行时执行代码、无哈希校验、不满足PEP 376,而whl遵循PEP 427,实现声明式安装与安全卸载。

whl 是当前唯一被 pip 官方支持的二进制安装格式;egg 已在 pip 10.0+ 中彻底移除,强行用会报 ERROR: *.egg is not a supported wheelhouse format。
pip install *.egg 直接报错的根本原因
这不是兼容性问题,而是设计层面的淘汰:
- egg 是运行时可导入格式,允许
setup.py在安装阶段执行任意代码,存在安全隐患 - pip 的目标是声明式安装:解压 → 复制 → 写
RECORD和INSTALLER→ 完成,不执行任何 Python 逻辑 - egg 使用的
PKG-INFO+requires.txt结构无法满足 PEP 376 对包元数据的校验要求,卸载时只能删目录,无哈希验证 - 自 pip 10.0(2018 年发布)起,所有对
.egg的直接安装支持已被硬编码移除
whl 文件名里那串下划线不是随便拼的
比如 numpy-1.26.4-cp39-cp39-win_amd64.whl,这五段是 PEP 427 强制定义的,作用是让 pip 在下载前就能精准过滤:
-
numpy-1.26.4:包名与版本,用于依赖解析 -
cp39:Python 实现与主次版本(CPython 3.9),cp39d表示调试构建 -
cp39(第二段):ABI 标签,none表示纯 Python,cp39表示 CPython 3.9 ABI 兼容 -
win_amd64:平台标签,manylinux2014_x86_64或macosx_10_9_universal2等也合法 -
.whl:扩展名,不可省略或替换
egg 文件名没有规范,mylib-1.0-py2.7.egg 这类写法全靠人工识别,pip 无法自动判断是否能装。
dist-info vs egg-info:卸载和校验能力差一个维度
安装后,whl 写入的是 package_name-1.2.3.dist-info/,egg 写入的是 package_name-1.2.3-py3.9.egg-info/。关键差异在内容:
-
dist-info必须含RECORD(每个文件的 SHA256 哈希)、WHEEL(wheel 规格版本)、INSTALLER(记录是 pip 还是 other 工具装的) -
egg-info只保证有PKG-INFO和requires.txt,无哈希、无安装器记录、无 ABI 描述 - 这意味着
pip uninstall能安全删除 dist-info 包,而对 egg-info 只能暴力删目录;pip check也只认 dist-info
whl 本质就是 ZIP,但 egg 不一定可靠解压
你把 xxx.whl 改成 .zip 后用系统自带解压工具或 zipfile 模块打开,100% 成功 —— 因为 PEP 427 明确规定:
- 必须使用 UTF-8 编码路径名
- 禁止加密、禁止跨卷压缩、禁止自解压头
而 egg 没有标准约束:
- 早期 Windows 上常见 GBK 编码路径,
zipfile默认读不出来 - 部分 egg 是目录形式(如
python setup.py develop生成的),根本不是 ZIP - 有些带签名块或附加元数据,普通 ZIP 工具会报“损坏”
所以当你需要读取包内资源(比如模板、配置、图标),用 importlib.resources 或 pkg_resources 是唯一可靠方式 —— 无论它是 whl 还是 egg,但 egg 已不该出现在你的工作流里。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











