首先，直接通过

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 版本、系统位数及文件完整性。

如有问题，建议更换 Python 版本或尝试不同来源的 wheel 文件。