mpdf 默认会强制缩放表格字体以适应单页，导致长文本显示过小；本文介绍通过结构优化（如拆分单元格内容为多行）或替代方案（避免表格布局）来实现长文本自然跨页，保持字体大小不变。

mpdf 默认会强制缩放表格字体以适应单页，导致长文本显示过小；本文介绍通过结构优化（如拆分单元格内容为多行）或替代方案（避免表格布局）来实现长文本自然跨页，保持字体大小不变。

在使用 mPDF 生成 PDF 时，若将大段文本直接置于

中，即使启用了 shrink_tables_to_fit = 1，mPDF 仍会优先尝试整体缩放整行（） 而非自然分页——这是其官方文档明确说明的行为：“mPDF will always resize tables if it is the only way to fit a row or whole table onto a full page”。这意味着：表格单元格内的长文本无法像普通段落一样自动断行至下一页，而是触发字体压缩机制，破坏可读性。

✅ 正确解决方案

方案一：将长文本拆分为多行 （推荐用于结构化数据）

将原本单个

中的大段内容，按语义或长度主动拆分为多个 ，使每行内容高度可控，从而允许自然分页：

$html = '

small text	First paragraph of large text...
	Second paragraph — continues on next page if needed.
small text	Another large block, independent of previous row.

';

⚠️ 注意：空

（如第二行首列）需保留以维持列对齐；也可用 colspan 或 CSS vertical-align: top 优化视觉一致性。

方案二：弃用表格，改用 CSS Flex/Grid 或语义化块级元素

对于非严格表格语义的布局（如表单、详情卡片），用

Opera Neon

Opera Neon是一款AI智能体工具，Opera推出的全新AI Agent浏览器。

下载

+ CSS 实现更灵活的分页控制：

$html = '<div style="display: flex; gap: 10px; margin-bottom: 12px;">
  <div style="flex: 0 0 120px; font-weight: bold;">Label:</div>
  <div style="flex: 1;">Very long descriptive text that can naturally wrap and break across pages without any font scaling.</div>
</div>';

配合 mPDF 的分页控制属性（如 page-break-inside: avoid 仅用于禁止断行，而默认 page-break-inside: auto 允许内容跨页），即可实现精准排版。

? 关键配置补充

• 禁用自动缩放：显式设置 $mpdf->shrink_tables_to_fit = 0;（默认为 1，需覆盖）；
• 启用内容分页：确保 内无 white-space: nowrap 等阻止换行的 CSS；
• 字体保障：指定 font-family 并嵌入字体（如 $mpdf->autoScriptToLang = true; 配合中文字体）。

✅ 总结

mPDF 的表格分页机制本质是“页内适配优先”，而非“内容流式分页”。要实现长文本跨页且保持字体大小，核心原则是：避免让超长内容困在单个 中。优先采用“逻辑拆行”或“去表格化布局”，辅以合理的 CSS 和 mPDF 配置，即可兼顾语义清晰性与 PDF 排版质量。