[python]windows上通过whl文件安装pyheif模块-Windows系列-PHP中文网

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

看不見的法師

发布： 2025-09-07 09:03:09

原创

452人浏览过

首先，直接通过

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]windows上通过whl文件安装pyheif模块

立即学习“Python免费学习笔记（深入）”；

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

3. 安装

.whl

登录后复制

文件

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

pip

登录后复制

安装下载好的

.whl

登录后复制

文件。假设你下载的是

pyheif-0.8.0-cp39-cp39-win_amd64.whl

登录后复制

，且文件位于

D:\downloads\

登录后复制

目录下，执行如下命令：

码上飞

码上飞（CodeFlying）是一款AI自动化开发平台，通过自然语言描述即可自动生成完整应用程序。

138

查看详情

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')
<h1>将 HEIC 转换为 PIL 图像对象</h1><p>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 版本、系统位数及文件完整性。