Pyheif/Libheic库HEIC转PNG脚本调试求助：结构体大小不匹配错误

第18行代码本身无问题 #

你贴出的convert_heic_to_png调用代码没有语法或逻辑错误：路径格式符合macOS规范，参数传递也符合函数调用要求。VS Code高亮该行只是因为脚本运行时抛出了全局错误，并非这行代码本身存在问题。

错误根源 #

报错ffi.error: struct heif_decoding_options: wrong total size (cdef says 48, but C compiler says 72)本质是pyheif库与底层libheic的ABI不兼容：

• pyheif的Cython定义文件中，heif_decoding_options结构体的大小被硬编码为48字节
• 但你系统中升级后的libheic编译出的该结构体实际大小为72字节
• 两者大小不匹配导致FFI调用时内存结构错位，触发错误

可行解决方法 #

方法1：重新编译pyheif绑定最新libheic #

卸载现有pyheif，从源码编译安装，确保编译过程链接你升级后的最新libheic：

pip uninstall pyheif
git clone https://github.com/david-poirier-csn/pyheif.git
cd pyheif
pip install .

方法2：改用兼容性更好的替代库 #

推荐使用pillow-heif（基于Pillow的HEIC扩展，无需单独处理libheic版本兼容）：

1. 安装库：

pip install pillow-heif

2. 替换原有转换代码：

from pillow_heif import register_heif_opener
from PIL import Image

register_heif_opener()
Image.open('/Users/jash/Desktop/to_read-learn/Nerding_out/IMG_8712.heic').save('/Users/jash/Desktop/Nerding_out/IMG_8712.png')

方法3：修改pyheif源码适配结构体 #

按错误提示修改pyheif的Cython定义文件（pyheif/heif.pxd），找到struct heif_decoding_options的定义，在末尾添加...;使其成为柔性数组：

struct heif_decoding_options {
    // 保留原有字段
    ...;
};

修改后重新编译安装pyheif即可。

内容的提问来源于stack exchange，提问作者jash