TCPDF 是 PHP 中生成发票、合同、报表最稳定的方案，因其对复杂表格、多页分栏、中文断行、页眉页脚重绘及Factur-X元数据支持可靠；而DomPDF与html2pdf在嵌套表格、分页、页眉偏移等方面易出错。
TCPDF 是目前 PHP 中生成发票、合同、报表最稳的方案，不是因为它功能最多，而是它对复杂表格、多页分栏、中文断行、页眉页脚重绘这些实际业务痛点处理得最可靠。
为什么不用 DomPDF 或 html2pdf 生成发票？
DomPDF 和 html2pdf 看似简单——写 HTML 就能出 PDF，但真实发票场景里，它们常在这些地方翻车：
-
table嵌套超过两层时，列宽计算失准，金额栏错位 - 中文长文本用
writeHTMLCell()渲染后突然截断，且不触发自动分页 - 页眉中插入公司 logo 后，第二页开始偏移 2px，导致所有页眉不对齐
- Factur-X 元数据（XML 结构化发票信息）完全不支持，无法对接德国/法国税务系统
TCPDF 虽要手写布局，但每个 Cell()、MultiCell() 的位置和高度都可控，发票关键字段（如税号、总计、签名区）不会“飘走”。
发票生成必须调用的 4 个 TCPDF 方法
别被例子目录里几十个 example_*.php 吓住，真正做发票只靠这四个方法组合就足够：
立即学习“PHP免费学习笔记（深入）”；
-
setHeaderData()：传入 logo 路径和公司名称，自动渲染到每页页眉；注意路径必须是服务器绝对路径，./images/logo.png会失败 -
writeHTMLCell()：把 HTML 片段（比如产品描述）塞进指定坐标区域；需配合setY()手动控制起始纵坐标，否则容易覆盖抬头 -
MultiCell()：画带自动换行的单元格，发票里的“备注”“条款”栏必用；宽度设为0表示占满剩余宽度，但高度不能设0，否则内容消失 -
Output()：最后一步，Output('invoice_' . $id . '.pdf', 'D')强制浏览器下载，'F'保存到服务器；别漏掉第二个参数，空字符串会导致空白 PDF
合同类文档的关键陷阱：签名区与分页控制
合同不像发票有固定行数，用户可能在“乙方签字”前加三段补充条款，导致签名页被挤到第二页末尾——而法律上签名必须紧接正文末尾。
解决方法不是靠猜页数，而是用 TCPDF 的页面锚点机制：
- 在正文结束前调用
addPage()强制翻页，再用setY(270)把光标定位到页面底部（A4 高 297mm，留 27mm 页脚） - 签名栏用
Cell(60, 10, '甲方签字：', 1, 0, 'L')+Cell(100, 10, '', 1, 1, 'C')组合，避免MultiCell()因内容为空导致高度塌陷 - 务必在
__construct()初始化时传入true, 'UTF-8', false，第三个参数false关闭 TCPDF 自带的字体子集嵌入，否则中文合同导出体积暴涨 3 倍
报表导出性能卡在哪儿？
当报表行数超 500 行，TCPDF 默认逐行 Cell() 会明显变慢。根本原因不是 PHP 性能，而是 TCPDF 每次调用都重复计算坐标和边框路径。
提速的关键动作只有两个：
- 用
startPageGroup()包裹整张报表，避免跨页时反复初始化页眉页脚 - 把数据先拼成 HTML 表格字符串（注意：仅限纯表格，不含 JS/CSS），再用
writeHTML()一次性写入，比循环Cell()快 3–5 倍；但必须提前用setHtmlVSpace(array())清空默认段间距，否则行高失控
真正难的从来不是“怎么生成”，而是“怎么让生成结果在不同打印机、不同 PDF 阅读器、不同税务系统里都保持像素级一致”——TCPDF 的确定性，就体现在它几乎不给你留意外发挥空间。
