一文厘清 PDF 中的 CropBox、TrimBox 与 BleedBox 有何不同

一、为何 PDF 页面不止一个尺寸？

很多开发者初次处理 PDF 文件时，往往认为 MediaBox 就是页面大小。但 PDF 的设计远比这复杂。在专业排版、印刷和数字出版领域，PDF 每页都可以定义多个“Box”来描述不同的可视与印刷区域。理解这些 Box 是精准布局、程序裁剪和颜色出血控制的前提。

二、五大 Page Box 的定义与差异

PDF 页面结构中，最多可定义以下五种 Box（均为 [llx lly urx ury] 格式的坐标数组）：

• MediaBox：页面物理尺寸，所有内容都绘制在其范围内。是必需字段。
• CropBox：显示器/阅读器中显示的区域。若未定义，默认使用 MediaBox。
• BleedBox：印刷出血区域，比 TrimBox 略大，保证裁切后边缘无空白。
• TrimBox：最终成品尺寸，是印刷裁剪线位置，通常用于商业印刷。
• ArtBox：艺术区域，用于描述主视觉内容（如插图、正文）的边界。

三、典型应用场景对照

Box 类型	常见应用
MediaBox	PDF 页面总体尺寸，打印设备必须遵循
CropBox	用户在 PDF 阅读器中看到的视图区域
TrimBox	印刷成品的最终尺寸，决定实际裁切边界
BleedBox	允许出血（Bleed）内容超出成品边缘 3mm
ArtBox	仅用于标记核心内容区域，非必须

四、实际开发与使用建议

• 用于屏幕展示的 PDF（如电子教材），建议设置 CropBox 等于 MediaBox，避免意外裁切。
• 用于印刷的 PDF，应确保 TrimBox 与 BleedBox 设置正确，以符合出血标准。
• 程序生成 PDF（如 ReportLab、jsPDF），建议至少定义 MediaBox 与 CropBox。

五、如何查看和修改页面 Box？

可使用专业 PDF 工具查看页面 Box：

• pdfinfo（Poppler 工具包）可查看各 Box 尺寸
• qpdf --qdf 解包 PDF 结构，查看每页 Page 对象
• PyMuPDF（fitz）、pdf-lib、PDFBox 等均可程序化读取和设置 Box

掌握 PDF 的页面 Box 结构，对于排版、印刷、数字出版、导出模板设计等场景具有重要意义。它是很多看似“边缘”的功能背后的底层原理。