FPDF原生不支持UTF-8中文，需替换为支持中文的TTF字体并用MakeFont.php生成字体文件，或直接改用MPDF/TCPDF；动态内容需手动调用Cell()/MultiCell()写入；输出空白多因HTTP头污染，应检查BOM、缓冲区及前置输出。
FPDF生成PDF时中文显示乱码怎么办
FPDF原生不支持UTF-8中文，直接输出中文会变成方块或空格。核心原因是它默认只加载Type1字体（如helvetica），而这些字体没有中文字符集。
解决路径只有两个：要么用iconv()或mb_convert_encoding()把中文转成CP1252（极不可靠，仅限ASCII扩展字符），要么换字体。推荐后者：
- 下载支持中文的TTF字体（如
simhei.ttf或msyh.ttc） - 用
MakeFont.php工具（FPDF官方提供）生成PHP字体描述文件（.php）和字形文件（.z） - 把生成的两个文件放进
font/目录，并在代码中调用AddFont()
注意：MakeFont.php必须在命令行运行，且依赖ttf2ufm工具；Windows用户容易卡在这一步——建议直接用tcpdf或mpdf替代，它们开箱支持UTF-8。
怎么把PHP动态内容写进PDF页面
FPDF不是模板引擎，不能像file_get_contents('template.php')那样直接渲染PHP逻辑。你得手动拼接数据、控制位置、分页。
立即学习“PHP免费学习笔记（深入）”；
典型流程是：AddPage() → SetFont() → 用Cell()、MultiCell()、Write()逐块写入内容。例如：
$pdf = new FPDF();
$pdf->AddPage();
$pdf->AddFont('simhei', '', 'simhei.php');
$pdf->SetFont('simhei', '', 12);
$pdf->Cell(0, 10, '订单号：' . $order_id, 0, 1);
$pdf->MultiCell(0, 6, '客户留言：' . htmlspecialchars_decode($message));
$pdf->Output();
关键点：
-
Cell()适合单行固定宽高内容，MultiCell()自动换行，但无法跨页续写 - 所有变量（如
$order_id）必须提前准备好，不能在Cell()里嵌套复杂表达式 - HTML标签（如
<br>）不会被解析，需手动换行或拆成多个MultiCell()
FPDF输出PDF失败但页面空白，怎么排查
常见原因不是代码错，而是HTTP头污染。FPDF的Output()会发送Content-Type: application/pdf，一旦之前有echo、var_dump()、BOM头、空格或错误警告，就会导致PDF损坏，浏览器显示空白。
快速检查项：
- 确认PHP文件保存为UTF-8无BOM格式（编辑器里看编码选项）
- 执行前加
ob_clean();和ob_end_clean();清空输出缓冲 - 临时注释掉所有非FPDF相关
echo/print_r，再试 - 把
Output()改成Output('F', '/tmp/test.pdf')先写到服务器磁盘，验证文件是否生成成功
如果写磁盘成功但浏览器输出失败，基本就是输出缓冲或header冲突问题。
为什么不用FPDF而选MPDF或TCPDF
FPDF轻量（一个类文件），但功能边界明显：不支持CSS、不解析HTML、不处理图片缩放、不自动分页表格、不兼容PHP 8.1+部分strict模式。实际项目中，只要涉及动态表格、样式、中文、图片混排，FPDF很快会卡住。
MPDF更现实：
- 直接
writeHTML()传入含<table>和内联<code>style的字符串 - 自动处理中文字体（只需指定
msi或simhei） - 支持
@pageCSS规则控制页眉页脚 - 错误提示清晰，比如
Unable to find TTF font file比FPDF的静默失败好调试得多
别为了“轻”硬扛FPDF——多引入一个Composer包（mpdf/mpdf）换来的是可维护性，不是性能瓶颈。
