mpdf 默认会强制缩放表格字体以适应单页，导致长文本显示过小；本文介绍通过结构优化（如拆分单元格内容为多行）或替代方案（避免表格布局）来实现长文本自然跨页，保持字体大小不变。
mpdf 默认会强制缩放表格字体以适应单页，导致长文本显示过小；本文介绍通过结构优化（如拆分单元格内容为多行）或替代方案（避免表格布局）来实现长文本自然跨页，保持字体大小不变。
在使用 mPDF 生成 PDF 时，若将大段文本直接置于
✅ 正确解决方案
方案一：将长文本拆分为多行 （推荐用于结构化数据）将原本单个
中的大段内容，按语义或长度主动拆分为多个
，使每行内容高度可控，从而允许自然分页：$html = '<table style="width: 793px;" autosize="1">
<tr><td>small text</td><td>First paragraph of large text...</td></tr>
<tr><td></td><td>Second paragraph — continues on next page if needed.</td></tr>
<tr><td>small text</td><td>Another large block, independent of previous row.</td></tr>
</table>';
⚠️ 注意：空
（如第二行首列）需保留以维持列对齐；也可用 colspan 或 CSS vertical-align: top 优化视觉一致性。方案二：弃用表格，改用 CSS Flex/Grid 或语义化块级元素
对于非严格表格语义的布局（如表单、详情卡片），用
+ 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 排版质量。
将原本单个
$html = '<table style="width: 793px;" autosize="1"> <tr><td>small text</td><td>First paragraph of large text...</td></tr> <tr><td></td><td>Second paragraph — continues on next page if needed.</td></tr> <tr><td>small text</td><td>Another large block, independent of previous row.</td></tr> </table>';
⚠️ 注意：空
（如第二行首列）需保留以维持列对齐；也可用 colspan 或 CSS vertical-align: top 优化视觉一致性。 方案二：弃用表格，改用 CSS Flex/Grid 或语义化块级元素
对于非严格表格语义的布局（如表单、详情卡片），用
+ 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 排版质量。
