使用TCPDF 6.7.5导出PDF时部分日文字符无法显示求助

架构老林

2026-6-24

TCPDF 6.7.5 日文扩展汉字显示及空白PDF问题解决建议

核心问题分析

你使用的日文汉字多属于CJK扩展B/C区字符（Unicode码位U+20000及以上），TCPDF默认的cid0jp、arialuni等字体未覆盖这类扩展字符；同时代码中Cell方法的参数错误，是导致空白PDF的直接原因。

具体解决步骤

1. 选用支持全Unicode扩展区的日文字体

放弃默认字体，选择完整支持CJK扩展字符的字体，比如：

Noto Sans JP（谷歌开源，覆盖全Unicode日文字符）
源柔ゴシック（日本开源字体，支持扩展字符）

2. 正确将自定义字体导入TCPDF

使用TCPDF自带的工具生成适配的字体文件：

下载字体文件（如NotoSansJP-Regular.otf），放到TCPDF的fonts/目录下
执行TCPDF自带的字体生成命令（在TCPDF根目录运行）：
```
php tools/tcpdf_addfont.php -i fonts/NotoSansJP-Regular.otf
```
生成完成后，fonts/目录会出现notosansjpregular.php等相关文件，后续代码中即可使用这个字体名。

3. 修正代码中的错误参数

原代码中Cell方法的最后一个参数为11，属于无效值（该参数仅支持0/1/2，分别代表不换行/换行到下一行/换行到下一页），这是生成空白PDF的关键原因。修正后的完整代码示例：

<?php 
require_once('tcpdf/tcpdf.php');

// 初始化PDF，确保UTF-8编码配置正确
$pdf = new TCPDF('P', 'mm', 'A4', true, 'UTF-8', false);

$pdf->setPrintHeader(false);
$pdf->setPrintFooter(false);

$pdf->AddPage();

// 使用生成的自定义字体（示例为Noto Sans JP常规体）
$pdf->SetFont('notosansjpregular', '', 12);

$string = "𠀋 𡈽 𡌛 𡑮 𡢽 𠮟 𡚴 𡸴 𣇄 𣗄";
// 修正Cell的换行参数为1，代表输出后换行到下一行
$pdf->Cell(190, 10, $string, 0, 1);

$pdf->Output();