PDF 页面尺寸指南：A4、Letter、4×6 标签与自定义毫米尺寸

如果你正在搜索“PDF 页面尺寸”“A4 PDF”“Letter PDF”，真正需要的通常不是临时导出，而是一套能处理真实数据、稳定版式和持续交付的文档流程。

页面尺寸是 PDF 模板最先确定、也最难事后修改的参数。A4 与 Letter 看似接近，却会改变换行和分页；4×6 标签若被放进 A4 页面，还会因打印缩放破坏条码。

本文面向生成报告、合同、发票、物流标签、票券、小票和其他需要精确打印尺寸的设计与开发团队。目标是根据阅读与打印设备选择正确纸张、方向和边距，并让模板元素、分页与打印机保持实际尺寸一致，最终交付A4/Letter 业务文档、横向报表、4×6 物流标签、自定义票券、收据、资产标签和小尺寸卡片，并让每份文件都能追溯到明确的数据与模板版本。

一、这个 PDF 场景真正难在哪里？

屏幕没有物理尺寸概念，打印机却有纸张、不可打印边缘、DPI 和驱动缩放。模板使用错误单位或方向时，文字会重排、表格换页、裁切线偏移，条码也可能失去可扫尺寸。

二、先建立字段与数据边界

开始设计页面前，至少要梳理以下数据：

page.width 与 page.height（毫米）：注明权威来源、类型与稳定业务含义。
orientation：区分必填、可选、空字符串与 null。
page_margin：提供正常值和最长合法值用于排版测试。
header_height 与 footer_height：写清格式、单位、时区或币种规则。
content_width 与 safe_area：定义缺失、零值与异常值的页面表现。
printer_dpi：设置校验失败提示，关键错误应阻止生成。
scaling_policy：准备多语言或特殊字符样本检查字体。
template_id、paper_profile 与 version：规定命名、排序与归档关联方式。

三、从业务数据到正式 PDF 的实施流程

第1步：从最终设备与纸张规格确认物理宽高

先把“从最终设备与纸张规格确认物理宽高”写成团队可执行的规则，明确数据负责人、批准人和异常处理人。对于A4/Letter 业务文档、横向报表、4×6 物流标签、自定义票券、收据、资产标签和小尺寸卡片，这一步越清楚，后续模板返工越少。

第2步：统一使用毫米定义页面和元素坐标

处理“统一使用毫米定义页面和元素坐标”时，记录选择依据并保存一份代表性样本。以后调整模板或接口时，可以用相同依据重新验证。

第3步：预留打印安全区、页眉页脚与裁切误差

围绕“预留打印安全区、页眉页脚与裁切误差”准备正常、空值、最长文本和最大数组四类数据，确认页面在真实边界下仍然完整可读。

第4步：根据方向重新分配表格列和视觉层级

执行“根据方向重新分配表格列和视觉层级”时，为请求设置业务标识、超时和明确失败分支；只有文件通过验收后，才把动作标记为成功。

第5步：生成 100% 比例测试页并测量实际输出

验收“生成 100% 比例测试页并测量实际输出”不能只看屏幕第一页，还要检查打印、跨页、字体、条码或交互状态等与场景有关的细节。

第6步：按纸张 profile 维护模板版本和打印说明

最后以“按纸张 profile 维护模板版本和打印说明”形成追溯闭环，保存业务 ID、模板版本、生成时间、页数和文件摘要，方便补发与审计。

四、三个必须提前做出的设计决定

1. A4 还是 Letter

根据接收地区和实际打印设备选择，不要简单缩放。两者宽高不同，会影响长表格和签名位置。

2. 纵向还是横向

大多数文本适合纵向，列较多的报表可用横向；先删减不必要列，再决定是否旋转页面。

3. 适应内容还是固定纸张

正式文件通常固定纸张并让内容分页；照片或特殊票券可以按设计使用自定义尺寸。

五、如何使用 KeepMot 落地

KeepMot JSON 页面使用毫米宽高，元素坐标同样以毫米表示，文本字号使用 points。可创建 A4、Letter、4×6 或任意正数自定义页面，并用 page_margin 管理正文安全区。

针对 PDF 页面尺寸，可以在 KeepMot Studio 中维护视觉模板，通过 Template API 只提交 template_id 和业务数据；完全由程序控制版式时使用 JSON Render API，已有网页资产时选择 HTML to PDF API。模板库可从这里查看。

六、上线验收清单

页面宽高符合纸张规范：保存源系统核对记录作为证据。
方向和边距与打印设置一致：保存页面或打印样本作为证据。
正文不进入不可打印区域：保存边界数据结果作为证据。
表格列宽适合新方向：保存响应状态与文件头作为证据。
100% 打印尺寸测量正确：保存模板版本和文件摘要作为证据。
条码和裁切样本通过实测：保存补发或重放记录作为证据。

七、常见风险与修正方法

风险 1：把像素直接当作毫米坐标

“把像素直接当作毫米坐标”会让早期看似灵活的实现快速积累维护成本。应在数据合同或发布流程中直接阻止这种状态。

风险 2：用 A4 设计后让驱动缩放到 Letter

出现“用 A4 设计后让驱动缩放到 Letter”时，最终页面可能仍然看似正常。必须同时核对源记录、关键标识和实际输出。

风险 3：标签模板外围保留整张 A4 页面

“标签模板外围保留整张 A4 页面”往往只在边界数据出现。把触发条件保存为回归样本，并为无法安全生成的内容返回明确错误。

风险 4：忽略打印机不可打印边缘

“忽略打印机不可打印边缘”可能造成交付、安全或运营事故。限制敏感值的暴露范围，并保留必要审计信息而不记录秘密。

风险 5：纸张改变后没有重新测试分页

针对“纸张改变后没有重新测试分页”，先区分数据、版式、投递和版本问题，再制定纠正、重试、撤销或补发规则。

八、批量、性能与日常运营

为每种纸张建立明确 paper_profile，并在模板名称、打印说明和任务数据中记录。批量任务不要混合不同纸张；打印机驱动锁定实际尺寸，设备更换后重新校准。

九、常见问题 FAQ

Q：A4 和 Letter 差多少？ A：A4 为 210×297 mm，US Letter 为 8.5×11 英寸，宽高都不同，足以影响换行和分页。

Q：4×6 标签应该建成多大？ A：按打印机与承运商规定使用实际 4×6 英寸或等效毫米尺寸，不要放在 A4 画布里。

Q：为什么 PDF 打印后变小？ A：阅读器或驱动可能启用了“适合页面”。应选择实际尺寸/100% 并使用匹配纸张。

Q：可以每页不同尺寸吗？ A：PDF 技术允许页面尺寸不同，但业务打印与归档通常更复杂，应确认流程是否支持。

Q：边距应该多大？ A：取决于打印机和内容。先确认不可打印区域，再为正文、页眉页脚和裁切保留安全空间。

Q：横向报表能自动转为纵向吗？ A：不能只旋转。列宽、字号、分页和视觉层级都要重新验证。