Wheel 是 Python 生態(tài)系統(tǒng)中的一種標(biāo)準(zhǔn)打包格式，用于分發(fā)和安裝 Python 包。它是 PEP 427 中定義的二進(jìn)制分發(fā)標(biāo)準(zhǔn)，旨在替代傳統(tǒng)的 .egg 格式，并加快包的安裝速度。與源碼分發(fā)相比，Wheel 格式可以直接包含編譯好的二進(jìn)制文件，使得安裝無(wú)需編譯過程，尤其適用于包含 C 擴(kuò)展的包。

安裝 ：

pip install wheel

常見應(yīng)用場(chǎng)景：

（1）快速安裝包

提供編譯好的二進(jìn)制文件，減少用戶安裝依賴的時(shí)間。

（2）跨平臺(tái)分發(fā)

Wheel 文件包含平臺(tái)和 Python 版本信息，便于打包和部署。

（3）自動(dòng)化打包工具

配合 setuptools、pip 等工具，實(shí)現(xiàn)包的自動(dòng)構(gòu)建與發(fā)布。

（4）提高 CI/CD 效率

在持續(xù)集成環(huán)境中，使用 Wheel 可以避免重復(fù)編譯源碼。

（5）支持 C 擴(kuò)展

對(duì)于包含 C/C++ 擴(kuò)展的 Python 包，Wheel 能直接分發(fā)編譯結(jié)果。

◆ ◆ ◆

核心概念

1、Wheel 文件結(jié)構(gòu)

Wheel 文件以 .whl 為擴(kuò)展名，內(nèi)部是一個(gè) ZIP 壓縮包，包含：

? 包的元數(shù)據(jù)：METADATA、WHEEL 文件。

? 源碼或編譯后的二進(jìn)制文件。

? 依賴信息（可選）。

2、兼容性標(biāo)簽

Wheel 文件名遵循格式：

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

例如：

numpy-1.25.0-cp311-cp311-win_amd64.whl

? cp311：適用于 CPython 3.11。

? win_amd64：適用于 Windows 64 位。

? 可清楚指明包的兼容 Python 版本和操作系統(tǒng)。

3、二進(jìn)制 vs 源碼 Wheel

? Binary wheel：包含編譯好的 C 擴(kuò)展，可直接安裝。

? Pure Python wheel：僅包含 Python 源碼，無(wú)需編譯。

4、構(gòu)建與安裝

? 構(gòu)建 Wheel 文件：python setup.py bdist_wheel 或 python -m build。

? 安裝 Wheel 文件：pip install some_package.whl。

◆ ◆ ◆

應(yīng)用舉例

例 1：構(gòu)建 Wheel 文件

python setup.py bdist_wheel

在 dist/ 目錄下生成 .whl 文件，可直接分發(fā)或上傳到 PyPI。

例 2：安裝本地 Wheel 文件

pip install dist/example_package-1.0.0-py3-none-any.whl

無(wú)需編譯源碼即可安裝，適合包含 C 擴(kuò)展的包。

例 3：查看已安裝包的 Wheel 信息

pip show numpy

可查看包的版本、安裝位置、依賴等信息。如果是 Wheel 安裝，通常會(huì)顯示 pip 的緩存路徑中 .whl 文件信息。

例 4：上傳 Wheel 到 PyPI

twine upload dist/example_package-1.0.0-py3-none-any.whl

利用 twine 將 Wheel 文件上傳到 PyPI，供其他用戶安裝。

例 5：構(gòu)建純 Python Wheel

python -m build --wheel

構(gòu)建純 Python 的 Wheel 文件，在跨平臺(tái)部署中非常方便。

◆ ◆ ◆

常用函數(shù)與工具速覽

bdist_wheel

用于構(gòu)建 Wheel 分發(fā)包。

參數(shù)：無(wú)（通過 setup.py 配置）。

返回：生成 .whl 文件存放在 dist/ 目錄。

pip install [package].whl

安裝 Wheel 文件。

參數(shù)：Wheel 文件路徑或文件名。

返回：將包安裝到當(dāng)前 Python 環(huán)境。

wheel.version()

查看已安裝 Wheel 庫(kù)的版本。

返回：版本號(hào)字符串，例如 '0.42.0'。

twine upload [file].whl

上傳 Wheel 文件到 PyPI。

參數(shù)：Wheel 文件路徑。

返回：上傳結(jié)果狀態(tài)。

小結(jié)

Wheel 是 Python 包的標(biāo)準(zhǔn)化二進(jìn)制分發(fā)格式，能夠加速安裝、支持 C 擴(kuò)展，并明確兼容性信息。

通過 bdist_wheel 構(gòu)建、pip install 安裝以及 twine upload 發(fā)布，開發(fā)者可以輕松管理和分發(fā) Python 包。

Wheel 極大提高了 Python 包管理的效率，已成為現(xiàn)代 Python 開發(fā)和部署的重要工具。

“點(diǎn)贊有美意，贊賞是鼓勵(lì)”