如何在PDF源码中插入图片？图片不显示问题排查

以下是针对你代码中问题的逐一排查和修复方案：

1. 内容流的/Length值完全错误 #

你在5号对象（页面内容流）中设置/Length 1，但实际stream内包含了大量绘制命令。PDF阅读器会严格按照/Length指定的字节数读取流内容，这会直接导致图片绘制命令/I1 Do被截断，根本不会执行。

• 修复方法：计算内容流的实际字节数，替换/Length的数值。手动编写时可通过工具统计stream和endstream之间的二进制字节数。

2. 图片对象的/Length值必须精准匹配JPEG数据 #

6号对象中/Length 2291必须和你插入的JPEG二进制数据的实际字节数完全一致。数值偏大或偏小都会导致PDF阅读器无法正确解析图片数据，直接忽略图片显示。

• 修复方法：用文件工具查看JPEG文件的字节大小，将该数值替换到/Length中。

3. 图片位置可能被窗口裁剪 #

你用1 0 0 1 0 0 cm把图片放在PDF坐标的左下角（原点位置），部分PDF阅读器的窗口可能会裁剪掉这个区域，导致你看不到图片。

• 修复方法：修改矩阵参数，比如改成1 0 0 1 100 100 cm，把图片移到页面中间位置。

4. JPEG数据格式需符合PDF要求 #

确保你插入的JPEG是基线RGB格式，不能是渐进式JPEG、灰度JPEG或CMYK JPEG，否则即使参数正确，阅读器也无法解码显示。

• 验证方法：用图片编辑工具导出为基线RGB的JPEG，再替换二进制数据。

修复后的关键代码片段 #

5 0 obj
<<
/Length 74  % 替换为实际计算的内容流字节数
>>
stream
q
1 0 0 1 100 100 cm  % 调整图片位置到页面中间
/I1 Do
Q
BT/F1 10 Tf
100 632 Td(Hello world!)Tj
ET
endstream
endobj

6 0 obj
<<
/Type /XObject
/Subtype /Image
/Filter /DCTDecode
/Width 50
/Height 50
/ColorSpace /DeviceRGB
/BitsPerComponent 8
/Length 2345  % 替换为实际JPEG文件的字节数
>>
stream
[实际JPEG二进制数据]
endstream
endobj

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