首先，直接通过
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模块](https://img.php.cn/upload/article/001/503/042/175720699828628.jpg)
立即学习“Python免费学习笔记（深入）”；
请根据你的 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 版本、系统位数及文件完整性。
如有问题，建议更换 Python 版本或尝试不同来源的 wheel 文件。
