[python]windows上通过whl文件安装pyheif模块

看不見的法師 2025-09-07 00:00:00 次阅读

首先，直接通过

pip install pyheif

是无法在 windows 上成功安装该模块的。因此，最便捷的方式是使用

.whl

文件进行安装。以下是详细的安装步骤：

1. 确认已安装 Python 和 pip

请确保你的系统中已正确安装 Python 和 pip。可以从 Python 官方网站下载对应版本的 Python 安装包。安装过程中勾选“Add Python to PATH”选项，pip 会自动一并安装。

2. 下载合适的

.whl

文件

由于 PyPI 官方并未为

pyheif

提供 Windows 平台的预编译 wheel 文件，你需要从其他可信的第三方资源获取。常见途径包括：

PyPI：通常只提供 Linux 版本，Windows 用户无法直接使用。
GitHub 发布页：目前官方未提供适用于 Windows 的二进制文件。
第三方镜像站点：推荐使用国内镜像站如
```
gitee.com/FIRC/pythonlibs_whl_mirror
```
，这里汇集了大量为 Windows 预编译的 Python 扩展包。

可选的

.whl

文件包括：

pyheif-0.8.0-cp313-cp313-win_amd64.whl
pyheif-0.8.0-cp312-cp312-win_amd64.whl
pyheif-0.8.0-cp311-cp311-win_amd64.whl
pyheif-0.8.0-cp310-cp310-win_amd64.whl
pyheif-0.8.0-cp39-cp39-win_amd64.whl
pyheif-0.8.0-cp38-cp38-win_amd64.whl
pyheif-0.8.0-cp37-cp37m-win_amd64.whl

请根据你的 Python 版本和系统架构（如 cp39 + win_amd64）选择对应的文件下载。

3. 安装

.whl

文件

打开命令行工具（CMD 或 PowerShell），使用

pip

安装下载好的

.whl

文件。假设你下载的是

pyheif-0.8.0-cp39-cp39-win_amd64.whl

，且文件位于

D:\downloads\

目录下，执行如下命令：

pip install D:\downloads\pyheif-0.8.0-cp39-cp39-win_amd64.whl

确保路径和文件名准确无误。

4. 验证安装是否成功

安装完成后，运行以下命令检查模块是否正常加载：

python -c "import pyheif; print(pyheif.__version__)"

如果输出版本号（如 0.8.0），说明安装成功。

你也可以使用以下代码读取 HEIC 图像文件：

from pyheif import read
image = read('example.heic')
将 HEIC 转换为 PIL 图像对象
from PIL import Image
pil_image = Image.frombytes(
mode=image.mode,
size=(image.width, image.height),
data=image.data,
decoder_name='raw')
pil_image.show()

注意事项

Python 版本匹配：务必确认
```
.whl
```
文件中的
```
cpXX
```
与你当前使用的 Python 版本一致（如 cp39 表示 Python 3.9）。
系统架构匹配：
```
win_amd64
```
适用于 64 位 Windows 系统，32 位系统不支持。
依赖库处理：
```
pyheif
```
依赖
```
libheif
```
、
```
libde265
```
等底层库。从第三方预编译的
```
.whl
```
安装时，这些依赖通常已被打包集成，无需额外配置。
若安装失败，请检查错误信息，确认 Python 版本、系统位数及文件完整性。