python wheel文件命名说明、whl文件命名规则、查询python兼容的版本

.whl文件(WHL file)也称为轮子(wheel)，这是用于python分发(distribution)的标准内置包格式(standard built-package format)。它包含安装所需的所有文件和元数据(metadata)。.whl文件使用zip进行压缩。.whl文件还包含有关此wheel文件支持的Python版本和平台的信息。.whl文件格式是一种即装即用格式(ready-to-install format)，允许在不构建源代码分发(without building the source distribution)的情况下运行安装包。

.whl文件本质上是zip文件，这些.whl文件可以使用解压缩选项(unzip option)或标准解压缩软件应用程序(如WinZIP和WinRAR)解压缩。

.whl文件按照以下约定命名：

{distribution}-{version}(-{build tag})? -{python tag}-{abi tag}-{platform tag}.whl

如果我们之前使用pip安装过Python包，那么我们的系统上很可能已经有轮子(wheel)被安装过。pip是安装wheel的包管理器。

我们可以通过pip安装已下载的.whl文件：pip install .whl ，安装包后，我们可以执行Python shell并尝试导入包：import whl_dist_name

wheel的直接好处是我们与其他人共享我们的包，他们不必担心构建它。他们只需pip install后即可使用该软件包。它也是一个更小的共享文件(与所有源代码相比)，安装速度更快，因为它不需要运行安装脚本。

flask-3.0.3-py3-none-any.whl

MarkupSafe-1.1.1-cp27-cp27m-win_amd64.whl

MarkupSafe-1.1.1-cp27-cp27mu-manylinux1_x86_64.whl

flask-3.0.3-py2.py3-none-any.whl

wheel 包的命名格式为 {distribution}-{version}(-{build tag})? -{python tag}-{abi tag}-{platform tag}.whl

其中各个 tag 的意义和取值在 PEP425 中有规定：PEP 0425

1、distribution： 模块名称。如numpy, flask，pyhive等。 2、version： 版本号 3、python tag python tag 标记了具体的 python 实现。其中：

举个例子，如果 wheel 包里面包含了 C 拓展，那么打包出来的 python tag 就是 cpxx，其中 xx 是具体的版本号，如 cp27.

4、platform tag platform tag也好理解，就是系统架构。比如

最陌生的恐怕是之间的 abi tag，这正是本文讨论的主题。

abi 这东西，看不见摸不着。系统上的东西嘛，敲下个命令就知道是什么操作系统；架构虽然玄乎点，不过也就是那么几种；然而有多少人知道自己当前使用的平台遵循着怎样的 abi 标准？什么时候 abi 可以兼容，什么时候又不可以？

Python 对此有另外一个 PEP：PEP 3149

如果 sysconfig 定义了 SOABI，那么就用 SOABI 的值。当然这是 Python 3 的事务，这里我自然不用管。如果没定义 SOABI，比如 Python 2，wheel 会生成一个类似的 abi tag。在 Python 的标准里，这个 abi 取决于打包时使用的 Python 实现。举 CPython 为例，首先必须包含的是实现名和版本号，比如 CPython2.7.9 对应的是 cp27.其次，需要包含构建 CPython 时特定的选项。具体来说，打包时会依次判断当前的 CPython 是否有下列的功能，如果有，加上对应的 flag：

通常，我们看到的 abi tag 会是这样的 cp27mu，这是因为 --with-pymalloc 是默认开启的，而包管理中分发的 CPython 会加上 --with-wide-unicode 选项。

有趣的是，如果打包时没办法判断 abi 类型，生成的 abi tag 会是 none。而如果 Python 包是不依赖特定的 abi 的纯 Python 实现，生成的 abi tag 也是 none。在安装时，值为 none 的 abi tag 会享受特殊待遇。这个下文再说。

另外同样的 Python 代码打出来 abi tag 相同的包，不一定完全一样。以我的亲身经历举例，pycrypto 这个库，在打包的时候会判断 libgmp 是否存在，如果存在，就构建 _fastmath 这个库。如果打包平台上存在 libgmp，打出来的包就会包含 _fastmath。反之，则不存在。而这两种情形下打出来的包，名字是一模一样的。

当然对于 abi tag 为 none 的包，它可以在任何一个 abi 版本上安装。因为所有的平台都至少支持 none abi。但如果一个平台上的 Python 如此古怪，以致于没办法确定它的 abi 类型，那么也就只能装上 abi tag 为 none 的包。

以MarkupSafe为例，https://pypi.org/project/MarkupSafe/1.1.1/#files网站提供了很多种类的whl文件，应该选择哪种呢？

首先：有些文件从命名上就能看出来支持什么系统，若有些文件不知道python是否支持的，可以通过下面的方式查看。

以下方式查看python兼容的whl版本

通过以下命令查看python兼容的版本

本人windows环境安装python27执行后如下：

python 3.0版本可以通过以下方式查看兼容的版本号