一、.whl 文件介绍

.whl 文件，也被称作轮子文件，是 Python 分发包的标准格式。它包含了安装所需的所有文件和元数据，使用 zip 进行压缩，并提供了关于支持的 Python 版本和平台的信息。.whl 文件本质上是一个 zip 文件，可以通过解压缩软件进行解压。

二、.whl 文件命名规则

一个标准的 .whl 文件命名遵循以下格式：

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

1. distribution-version

这部分代表包的版本号，通常遵循 PEP 440 版本规范。

2. build tag

可选的构建标记，用于表示特定构建的版本，如 rc 表示候选发布版本。

3. python tag

这部分表示包支持的 Python 版本，例如 cp39 表示支持 Python 3.9。

4. abi tag

ABI（Abstract Base Interface）标签，表示编译器使用的架构，例如 cp39 表示 CPython 3.9。

5. platform tag

平台标签，表示支持的操作系统和架构，如 win_amd 表示 Windows 位。

6. .whl

文件扩展名，表示这是一个 wheel 文件。

三、命名技巧

1. 识别包版本

通过查看文件名中的版本号，可以快速识别包的版本，这对于更新或回滚包版本非常有用。

2. 识别支持的 Python 版本

通过 python tag，可以判断 wheel 是否与当前 Python 版本兼容。

3. 识别平台兼容性

平台标签可以帮助开发者判断 wheel 是否适用于自己的操作系统和架构。

4. 使用命名规范

遵循命名规范可以使 wheel 文件更加整洁和易于管理。

四、常见命名示例

以下是一些常见的 .whl 文件命名示例：

  • requests-2.25.1-py3-none-any.whl
  • numpy-1.21.2-cp39-cp39-win_amd.whl
  • opencv-python-headless-4.5.5.62-cp39-cp39-manylinux1_x86_.whl

五、总结

掌握 .whl 文件命名规范和技巧，可以帮助开发者更好地识别、管理和使用第三方库。遵循命名规范，可以提升项目代码的可读性和可维护性。