如何在 Dompdf 中正确显示中文字符：支持 UTF-8 与中文字体配置
dompdf 默认不支持中文，需手动配置支持 unicode 的中文字体（如 notosanscjk）、启用字体目录、设置默认字体并确保 html 编码统一为 utf-8，才能正常渲染中文文本。
dompdf 默认不支持中文，需手动配置支持 unicode 的中文字体（如 notosanscjk）、启用字体目录、设置默认字体并确保 html 编码统一为 utf-8，才能正常渲染中文文本。
在使用 Dompdf（v0.8.0+）将含中文的 HTML 转换为 PDF 时，出现“方块乱码”（ 或 □）是典型字体缺失问题。Dompdf 内置字体（如 DejaVu Sans）虽支持部分 Unicode 字符，但不包含中日韩（CJK）汉字字形，因此即使 HTML 正确声明 UTF-8 编码且浏览器可正常显示，PDF 渲染仍会失败。
✅ 正确解决方案（四步到位）
准备支持 CJK 的 TrueType 字体文件
推荐使用 Google 开源字体 Noto Sans CJK（如 NotoSansCJKtc-Regular.ttf，繁体中文版），下载后存放于项目字体目录（例如 assets/fonts/）。注意：字体文件名需与 CSS 或配置中引用的名称严格一致（区分大小写、不含空格）。显式配置字体路径与默认字体
必须通过 $options->set('fontDir', ...) 指向字体目录，并设置 defaultFont 为该字体的注册名（非文件名）。Dompdf 会在首次运行时自动解析 .ttf 并生成缓存字体文件（.ufm, .php），因此首次渲染可能稍慢，且需确保 fontDir 目录可写。禁用冗余的 HTML 字体声明（关键！）
<style>@font-face{...}</style> 在 Dompdf 中基本无效（v0.8.0 不支持动态 @font-face 加载远程或相对路径字体）。应完全移除此类 CSS，仅依赖 PHP 层配置的 defaultFont。-
确保全流程 UTF-8 编码一致
- HTML 模板头部必须包含 <meta charset="UTF-8">；
- PHP 中使用 mb_convert_encoding($html, 'HTML-ENTITIES', 'UTF-8') 是兼容性写法，但更推荐直接保证 $html 原生为 UTF-8 字符串（现代框架如 CodeIgniter 3+ 默认支持）；
- 避免重复调用 define("DOMPDF_UNICODE_ENABLED", true) —— v0.8.0+ 已默认启用 Unicode。
✅ 完整可运行代码示例
require 'assets/dompdf1/autoload.inc.php';// ⚠️ 关键：指定字体目录（绝对路径，确保可读写）define('DOMPDF_FONT_DIR', __DIR__ . '/assets/fonts/');$options = new Options();$options->set('isPhpEnabled', false); // 生产环境建议关闭 PHP 解析（安全）$options->set('fontDir', DOMPDF_FONT_DIR);$options->set('defaultFont', 'NotoSansCJKtc-Regular'); // 注意：此处为字体注册名，非文件名$dompdf = new Dompdf($options);$html = $this->load->view('view_view', $data, TRUE);// 无需 mb_convert_encoding，只要 $html 本身是 UTF-8 即可$dompdf->loadHtml($html, 'UTF-8'); // 显式声明编码更稳妥$dompdf->setPaper('A4', 'landscape');$dompdf->render();$dompdf->stream('View.pdf', ['Attachment' => false]);exit;
⚠️ 常见陷阱与验证步骤
- 字体注册名 ≠ 文件名：NotoSansCJKtc-Regular.ttf 的注册名通常为 NotoSansCJKtc-Regular（可通过 dompdf/lib/fonts/ 下生成的 .php 缓存文件确认）；
- 字体目录权限：若首次运行未生成 .ufm/.php 缓存，检查 DOMPDF_FONT_DIR 是否可写；
- 避免混合字体：不要在 CSS 中设 font-family: 'NotoSansCJK', DejaVu Sans —— Dompdf 仅使用 defaultFont，其余字体被忽略；
- 调试技巧：启用 error_reporting(E_ALL)，查看是否报错 Unable to load font；检查 DOMPDF_FONT_DIR 下是否生成了 notosanscjktc-regular.ufm 等文件。
完成上述配置后，中文将清晰渲染，无方块、无乱码。Dompdf 的中文字体支持本质是「预加载 + 缓存映射」，而非实时解析，因此一次配置，长期生效。
