TCPDF生成中文PDF显示方块是因为默认字体不支持UTF-8，需将simfang.ttf等中文字体放入fonts目录并用addTTFfont()注册生成PHP字体文件后，再通过SetFont()调用。
用 TCPDF 生成中文 PDF 为什么全是方块？
因为默认不支持中文字体。TCPDF 自带的字体（如 helvetica）是西文字体，没有中文字符映射，直接写中文就会显示为方块或空白。
解决办法是显式添加支持 UTF-8 的中文字体，推荐用 simfang.ttf（仿宋）或 msyh.ttf（微软雅黑），但注意：必须把字体文件放在 TCPDF 的 fonts/ 目录下，并用 addTTFfont() 注册。
- 先执行一次
$pdf->addTTFfont('/path/to/simfang.ttf', 'TrueTypeUnicode', '', 32)，它会生成一个simfang.php和simfang.z文件到 fonts 目录 - 之后才能用
$pdf->SetFont('simfang', '', 12) - 确保 PHP 开启
mbstring扩展，否则addTTFfont()会报错mb_convert_encoding(): Unknown encoding "UTF-8"
FPDF 中文乱码或崩溃怎么办？
FPDF 原生完全不支持 UTF-8，强行传中文字符串大概率导致输出中断、PDF 损坏，或者在浏览器里提示“无法打开此 PDF 文档”。
别硬扛，直接换扩展：用 fpdf + utf8 补丁版（比如 fpdi 或更常见的 tcpdf 替代方案），或者改用 mpdf——它对中文更友好，mpdf 只需设置 new \Mpdf\Mpdf(['autoScriptToLang' => true, 'autoLangToFont' => true]) 就能自动选中文字体。
立即学习“PHP免费学习笔记（深入）”；
- 如果你坚持用 FPDF，必须先把中文转成 ISO-8859-1 兼容编码（几乎不可行），或用
iconv('UTF-8', 'GB2312//IGNORE', $text)—— 但会丢字，不推荐 - 检查是否调用了
AddFont()，且路径正确；错误路径会导致Fatal error: Uncaught Exception: Could not include font definition file - FPDF 的
Cell()对超长中文文本不会自动换行，得手动拆分或改用MultiCell()
TCPDF 输出空白页或 Content-Type 错误
常见于 header 已经被输出过（比如前面有空格、BOM、echo 或调试语句），导致 TCPDF 的 Output() 调用失败，浏览器收到的是 HTML 头 + PDF 二进制混合内容。
另一个高频原因是没设对 Content-Type，尤其在 Laravel 或 ThinkPHP 等框架里，响应头可能被中间件覆盖。
- 确认脚本开头没有空行、BOM 字节（用编辑器查“UTF-8 with BOM”并转成无 BOM）
- 调用
$pdf->Output('report.pdf', 'I')前，确保没任何echo、var_dump、print_r，也不要在类构造函数里直接输出 - 如果强制下载，用
'D'模式；如果内嵌浏览器预览，用'I'；别用'S'（返回字符串）却忘了echo，那页面就真空白了 - Apache 下注意
mod_headers是否启用，Nginx 需手动加add_header Content-Type application/pdf;
生成带表格和图片的 PDF 性能很慢？
TCPDF 渲染复杂布局（尤其是嵌套 MultiCell 表格 + 多张图片）时，CPU 占用高、内存增长快，10 页以上文档容易超时或 OOM。
根本原因是 TCPDF 是纯 PHP 实现，每行、每格都做坐标计算，没缓存机制；图片还要重采样、嵌入 Base64。
- 大图务必提前压缩并转成 JPG（比 PNG 小 60%+），尺寸缩放到实际显示大小，别传原图
- 避免在循环里反复调用
Image()或WriteHTML()；先把 HTML 内容拼好再一次性写入 - 表格尽量用
writeHTML('<table>...') 而非手动画线 + <code>Cell()，前者由内置 HTML 解析器优化过 - 考虑异步生成：把 PDF 任务扔进队列，生成完存文件，前端轮询下载链接
真正难的不是“怎么生成”，而是“怎么稳定生成带业务数据、多语言、可打印的 PDF”——字体路径、编码链、输出缓冲、服务器配置，漏掉一环就卡在方块或空白页上。
