openexr 读取 hdr 图像崩溃或空指针的主因是未调用 ilmimf::initialize()；多通道错位因未按 channel 手动配置 framebuffer；写入体积大因默认无压缩，颜色溢出因未做伽马反转；链接失败因库顺序错误或版本混用。
OpenEXR 读取 HDR 图像时程序崩溃或返回空指针
常见原因是没正确初始化 OpenEXR 的全局 IO 系统，或者传入了不支持的压缩格式路径。OpenEXR 默认不自动注册所有 I/O 处理器，IlmImf::initialize() 必须显式调用，否则 Imf::InputFile 构造可能抛异常或静默失败。
实操建议：
- 在任何 OpenEXR 文件操作前，加一句
IlmImf::initialize()；程序退出前配对调用IlmImf::terminate() - 检查文件是否真为 EXR：用命令行
file image.exr或十六进制查看前几个字节是否为0x76-0x2f-0x31-0x01（“v/1\001”） - 避免直接用
std::ifstream读路径再传给Imf::InputFile——它只接受const char*路径，且内部会自己 fopen；若路径含中文或特殊字符，确保编译环境支持 UTF-8 路径（Linux/macOS 通常 OK，Windows 需用Imf::InputFile(const std::string&)重载或转宽字符）
读取多通道 EXR（如 R/G/B/A/Y/Cb/Cr）时数据错位或全黑
OpenEXR 不保证通道顺序与内存布局一致，Imf::FrameBuffer 需要按每个通道的 type、xStride、yStride 和 base 手动对齐。常见错误是把所有通道都塞进同一块连续内存，但实际各通道像素可能非连续存放，尤其当图像宽不是 4/8 倍数时，对齐边界会变化。
实操建议：
- 用
file.header().channels()遍历确认通道名和Imf::Channel类型（如Imf::FLOAT或Imf::HALF），别硬编码索引 - 为每个通道单独分配内存，并用
frameBuffer.insert(name, Imf::Slice(type, addr, xStride, yStride))注册；xStride单位是字节，对 float 是sizeof(float)，但必须乘以通道数？不，是单通道内相邻列像素的字节偏移——通常是sizeof(float)；yStride是相邻行的字节偏移，即width * sizeof(float) - 读之前务必调用
file.setFrameBuffer(frameBuffer)，漏掉这句不会报错，但读出来全是零
写入 EXR 时文件体积异常大或加载后颜色溢出
默认写入的是未压缩、32 位 float 的 Imf::FLOAT 格式，体积比 JPEG 大几十倍很正常；而颜色溢出（比如本该是 [0,1] 的 sRGB 值写成 [0,100]）是因为 OpenEXR 本身不定义色彩空间——它只存原始线性值，读写双方必须约定解释方式。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
实操建议：
- 写入前设置压缩：用
Imf::OutputFile(file, header, Imf::ZIP_COMPRESSION)，ZIP在保持质量前提下压缩率较好；避免PIZ（对噪声图效果差）或NO_COMPRESSION - 显式写入
"chromaticities"、"whiteLuminance"、"adoptedNeutral"等属性到Imf::Header，否则其他软件（如 Photoshop、Nuke）无法正确还原白点或 gamma - 如果源数据是 sRGB，请先做伽马反转（
pow(x, 2.2)）再写入；OpenEXR 不做自动转换，写了什么就是什么
C++ 编译链接 OpenEXR 失败：undefined reference 到 Imf* 符号
根本原因不是头文件没找到，而是链接时没指定正确的库顺序或漏了依赖库。OpenEXR 拆成多个子库（IlmImf、Iex、Imath、IlmThread），且有隐式依赖关系：IlmImf 依赖 Iex 和 Imath，多线程版还依赖 IlmThread。
实操建议：
- 链接顺序必须是
-lIlmImf -lIex -lImath -lIlmThread（如果启用了线程）；顺序反了会报大量undefined reference to `Iex::BaseExc::... - 用
pkg-config --libs OpenEXR获取准确链接参数（推荐）；若手动写，注意 macOS 上需加-lz（zlib）和-lpthread - 检查 OpenEXR 版本：2.x 和 3.x ABI 不兼容；
Imf::InputFile在 3.x 中已移到namespace OpenEXR，头文件也从ImfInputFile.h变成OpenEXR/ImfInputFile.h，混用会导致编译通过但运行崩溃
OpenEXR 的坑不在 API 多难懂，而在那些不报错却悄悄失效的细节：没调 initialize()、没设 setFrameBuffer()、链接库顺序错、通道 stride 算错字节——它们不会打断编译，但会让图像变成黑块、花屏或空指针。处理前先用 exrheader image.exr 看真实 channel 和 compression，比盲调代码快得多。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
