本文旨在解决在使用TCPDF生成PDF文件时，自定义TTF字体出现乱码的问题。通过分析字体文件本身以及TCPDF加载字体的机制，提供了一种有效的排查和解决思路，包括字体来源选择、字体缓存清理以及正确的字体加载和使用方法，确保PDF文件中自定义字体能够正确显示。
在使用TCPDF生成PDF文档时，自定义字体可以极大地丰富文档的视觉效果。然而，有时会遇到自定义字体在PDF中显示为乱码的问题。这通常与字体文件本身、TCPDF的字体加载机制以及字体的使用方式有关。下面将详细介绍如何排查并解决此类问题。
### 1. 字体文件来源
字体文件是显示效果的基础。如果字体文件本身存在问题，例如文件损坏或
编码不完整，那么在TCPDF中使用时就会出现乱码。
**建议：**
* **选择可靠的字体来源。** 优先选择官方网站或知名的字体库下载字体文件。
* **尝试不同的字体文件。** 如果一个字体文件出现问题，可以尝试从其他来源下载相同或类似的字体文件。
* **检查字体文件格式。** 确保字体文件格式正确，通常为`.ttf`。
案例中，作者发现从
google-webfonts-helper 下载的 Quicksand 字体显示乱码，而从 fontmirror 下载的相同字体却能正常工作，说明字体文件本身存在问题。
### 2. TCPDF字体缓存
TCPDF在加载字体时，会将字体信息缓存到指定目录中。如果之前加载过同名的字体，TCPDF可能会直接使用缓存中的字体信息，而不会重新加载新的字体文件。这可能导致即使更换了正确的字体文件，PDF中仍然显示乱码。
**解决方案：**
* **手动删除字体缓存。** TCPDF的字体缓存目录通常位于`vendor/tecnickcom/tc
pdf/fonts`。删除该目录下的相关字体文件，强制TCPDF重新加载字体。
**注意：** 在生产环境中，不建议直接修改`vendor`目录下的文件。可以考虑使用TCPDF的配置选项来指定自定义的字体缓存目录。
### 3. 正确加载和使用字体
即使字体文件没有问题，并且清除了字体缓存，如果加载和使用字体的方式不正确，仍然可能出现乱码。
**步骤：**
1. **加载字体文件。** 使用`TCPDF_FONTS::addTTFfont()`函数加载字体文件。
```
php
<?php
require_once('vendor/tecnickcom/tcpdf/tcpdf_include.php');
$fontnames = [];
$fontnames[] = TCPDF_FONTS::addTTFfont('fonts/Quicksand-Bold.ttf');
$fontnames[] = TCPDF_FONTS::addTTFfont('fonts/Quicksand-Regular.ttf');
// 输出字体名称，方便后续使用
die(print_r($fontnames, 1));
?>
**注意：** `addTTFfont()`函数只需调用一次即可，无需每次生成PDF都调用。
-
设置字体。 使用$pdf->setfont()函数设置字体。
<?php
require_once('vendor/tecnickcom/tcpdf/tcpdf_include.php');
$pdf = new TCPDF('P', 'mm', 'A4');
// 假设 addTTFfont 返回的字体名称为 'quicksand'
$pdf->SetFont('quicksand');
$pdf->AddPage();
$txt = '0123456789 ABCDEFGHIJKLMNOPQRSTUVQXYZ';
// 打印文本
$pdf->Write(0, $txt, '', 0, 'C', true, 0, false, false, 0);
$pdf->Output('test.pdf', 'I');
exit(1);
?>注意： SetFont()函数的参数是addTTFfont()函数返回的字体名称，而不是字体文件的文件名。
4. 编码问题
如果以上步骤都无法解决问题，可能是编码问题导致的。TCPDF默认使用UTF-8编码，如果字体文件或文本内容使用其他编码，可能会出现乱码。
解决方案：
确保字体文件支持UTF-8编码。
GentleAI
GentleAI是一个高效的AI工作平台，为普通人提供智能计算、简单易用的界面和专业技术支持。让人工智能服务每一个人。
下载
-
在TCPDF中设置正确的编码。 可以使用$pdf->SetFont()函数的第三个参数指定编码。
$pdf->SetFont('quicksand', '', 12, '', false, 'UTF-8');
总结
解决TCPDF自定义字体乱码问题需要综合考虑字体文件、TCPDF字体缓存以及字体加载和使用方式。通过选择可靠的字体来源、清理字体缓存、正确加载和使用字体，以及处理编码问题，可以有效地解决此类问题，确保PDF文件中自定义字体能够正确显示。
