C++中无法直接用标准库读取HEIC/HEIF，必须通过libheif联合libde265等解码器解析容器并解码像素，或在macOS下使用Core Image原生支持。
HEIC/HEIF在C++中不能直接用标准库读取
标准C++（包括std::ifstream、stb_image、OpenCV默认编译）完全不支持HEIC/HEIF。这不是编码问题，而是格式本身依赖苹果私有或ISO基础媒体文件结构+AV1/HEVC压缩，必须通过专用解码器链路处理。直接尝试用fopen读取后调jpeg_read_header之类会立即失败，报错类似Invalid JPEG file structure。
必须用libheif + libde265（或dav1d）组合解码
libheif是目前最成熟、被ImageMagick和GIMP采用的开源HEIF解析库，但它只负责容器解析和元数据提取，**不自带图像解码能力**；实际像素解码需绑定外部解码器：
-
libde265：官方参考解码器，支持HEVC，但已停止维护，对部分新HEIC（如带Alpha、多图层、HDR元数据）兼容性差 -
dav1d：现代AV1解码器，不适用——HEIC绝大多数用HEVC，不是AV1 -
libaom：AV1解码器，同样不适用 - 正确选择：libde265 + 启用
--enable-libde265编译libheif，或改用libheif的libx265后端（需自行编译x265并链接）
示例初始化代码片段：
heif_context* ctx = heif_context_alloc();
heif_error err = heif_context_read_from_file(ctx, "photo.HEIC", nullptr);
if (err.code != 0) {
// 注意：不是所有HEIC都含ID=0主图，需先heif_context_get_number_of_images()
// 再heif_context_get_image_handle()按索引取
}
heif_image_handle* handle;
heif_context_get_image_handle(ctx, 0, &handle); // 可能越界
OpenCV cv::imread("xxx.HEIC") 永远返回空Mat
OpenCV 4.8及之前所有版本，cv::imread底层调用的是libjpeg/libpng/libtiff等，完全不识别.HEIC扩展名，也不会尝试调用libheif。即使系统已安装libheif，OpenCV也无自动桥接机制。
立即学习“C++免费学习笔记（深入）”；
- 强行注册自定义解码器需重编译OpenCV，并打patch注入
libheif回调，工程量大且不可移植 - 更可行路径：先用
libheif解码为uint8_t*内存缓冲区（RGB或RGBA），再用cv::Mat(height, width, CV_8UC3, data_ptr)封装 - 注意色彩空间：
libheif默认输出是heif_colorspace_RGB，但可能为heif_chroma_interleaved_RGB或_RGBA，需检查heif_image_get_bits_per_pixel()和heif_image_has_alpha_channel()
macOS上用Core Image API是最省事的替代方案
如果你只面向macOS部署，libheif反而绕远路。系统原生Core Image（C++可调Objective-C++混编）直接支持HEIC，无需第三方依赖，且能正确处理HDR、广色域（P3）、深度图等扩展信息：
- 关键函数：
CGImageSourceCreateWithURL→CGImageSourceCreateImageAtIndex→CGBitmapContextCreate - 输出是
CGImageRef，可转为cv::Mat：用CGBitmapContextGetData取像素指针，注意字节序（macOS默认BGRA） - 缺点：Windows/Linux不可用；Xcode工程需开启Objective-C++（.mm后缀）
真正麻烦的从来不是“怎么读”，而是“读出来是什么”——HEIC里可能藏了多个图像（缩略图、主图、深度图）、不同色彩配置文件、非标准YUV采样，libheif默认只给你第一个RGB平面，其余得手动遍历heif_context_get_list_of_metadata_block_IDs去捞。
