PDF解析需先解析结构再提取图像，libpoppler和pdfium可可靠处理编码、对象流及颜色空间；ZIP工具直接解压99%失败。
PDF 解析不是解压，libpoppler 和 pdfium 是更可靠的选择
直接用 ZIP 工具或 unzip 打开 PDF 试图提取图片，99% 会失败——PDF 中的图像资源不是独立文件，而是经过编码（FlateDecode、DCTDecode、JPXDecode 等）、嵌套在对象流（object stream）或交叉引用表（xref）中的字节流。你得先解析 PDF 结构，定位到 /XObject 字典里类型为 /Image 的子对象，再还原其原始字节和元信息。
推荐用 libpoppler（C++ 接口稳定，支持 CMYK/JPX/16-bit）或 Google 的 pdfium（更底层，适合定制解码逻辑）。别碰 libpdf 或自制 parser——缺少对流过滤器链、预测器（Predictor 2）、颜色空间转换（如 /ICCBased）的支持，极易输出错位、偏色或崩溃。
poppler::Page::renderToImage() 只能导出渲染结果，不是原始嵌入图
很多人误以为调用 renderToImage() 就能“提取图片”，其实它只是把页面光栅化成一张位图（比如 300 DPI 的 QImage），丢失了原始分辨率、DPI 元数据、Alpha 通道结构、矢量混合痕迹，且无法区分多个重叠图像对象。真正提取嵌入资源，必须绕过渲染层，直读 poppler::Document 的内部对象树。
关键路径是：
立即学习“C++免费学习笔记（深入）”；
- 遍历每页的
poppler::Page::resources()获取/XObject字典 - 对每个
XObject检查dict->lookup("Subtype") == "Image" - 用
poppler::Object::streamGetLength()和streamToRawData()提取原始字节 - 从字典中读取
Width、Height、ColorSpace、BitsPerComponent、Filter等键值
注意：streamToRawData() 返回的是已解码后的原始字节（如 JPEG 数据），但若含多级过滤器（例如 [ /FlateDecode /DCTDecode ]），poppler 默认只解最后一层；需手动检查 Filter 类型并按顺序逆向处理。
颜色空间与位深不匹配会导致图像发绿、发灰或全黑
PDF 图像的颜色空间可能是 /DeviceRGB、/DeviceCMYK、/Indexed、/ICCBased，甚至带 /Mask 或 /SMask。直接把字节写成 .jpg 或 .png 文件，很可能显示异常——尤其 CMYK 图像被当 RGB 解码时，绿色通道会吃掉青色分量，整图泛绿。
实操建议：
- 遇到
/ICCBased，必须从对象中提取 ICC profile（dict->lookup("ColorSpace")->arrayGet(1)->streamToRawData()），否则无法正确转 sRGB -
/Indexed图像需读取dict->lookup("ColorSpace")->arrayGet(1)指向的 base color space 和dict->lookup("Lookup")的调色板数据 -
BitsPerComponent为 1、2、4、8、16 时，PNG 支持原生保存；但 JPEG 只接受 8-bit，16-bit 图需先降采样或存为 TIFF - 有
/SMask时，要同时提取掩码流，并合成带 Alpha 的 PNG，不能只存主图像
PDF/A 或加密 PDF 会让 getObjectStream() 返回空，必须预处理
PDF/A 文档常将图像对象打包进对象流（object stream），而默认的 poppler::Object 构造函数不会自动解包。如果 obj.isStream() 为 false，但 obj.isRef() 为 true，就得先调用 doc->resolveReference(obj.ref(), &obj)；若仍为空，说明该 ref 指向 object stream 内部，需用 doc->getCatalog()->getObjectStream() 遍历并手动查找。
加密 PDF 更麻烦：即使密码为空（""），也要显式调用 doc->isLocked() ? doc->unlock("") : true，否则所有 streamToRawData() 调用返回空字节。另外，某些文档用 /U 和 /O 字段做权限控制，poppler 不校验使用权限，但若图像被标记为 /Encrypt 子对象，仍需用 doc->decrypt() 主动触发解密流程。
最易忽略的一点：PDF 版本 ≥ 1.5 后大量使用交叉引用流（xref stream），poppler 默认启用，但旧版构建可能禁用——确认编译时启用了 -DENABLE_XREF_STREAMS=ON，否则 resolveReference 会静默失败。
