根本原因是字体路径未被正确读取或中文编码不匹配：必须使用绝对路径且确保Web进程有读取权限，同时字体需支持中文字符集、字符串编码须与字体一致（如GBK字体需转码）。
imagettftext() 报错“Invalid font filename”或文字变方块
根本不是字体文件坏了，而是 imagettftext() 收到的路径根本没被 PHP 读到。Linux 下常见于路径含中文、空格或用了相对 URL；Windows 下则多因反斜杠未转义或字体路径权限不足。
必须用绝对路径，且确保 Web 进程有读取权限：
-
__DIR__ . '/fonts/simhei.ttf'比'./fonts/simhei.ttf'可靠 - Linux 上路径中不能出现中文或空格，如
/var/www/html/中文目录/→ 必须重命名为/var/www/html/chinese_font/ - Windows 路径需双反斜杠或正斜杠：
C:\fonts\simhei.ttf或C:/fonts/simhei.ttf，单反斜杠会触发转义（ - 检查 PHP 进程用户能否读取该文件：
ls -l /path/to/font.ttf，若属主不是www-data或apache，需chmod 644并确认父目录可执行（x权限）
中文显示为乱码或空白方块
GD 的 imagettftext() 不接受 UTF-8 字符串直接输入，也不自动选字形——它只按字节流查字体里的 glyph 索引。你传 "你好"，它就去字体里找 Unicode 码位 U+4F60、U+597D 对应的字形；如果字体不包含这些码位（比如 Arial），就画不出。
两个硬性条件缺一不可：
立即学习“PHP免费学习笔记（深入）”；
- 字体文件本身必须是支持 GBK/GB2312 或 Unicode BMP 区中文的 TrueType 字体，例如
simhei.ttf、msyh.ttc、NotoSansCJKsc-Regular.otf；系统自带的Arial.ttf或Helvetica.ttf不行 - 传入的字符串必须与字体编码匹配：若用 GBK 字体，就得把 UTF-8 文本转成 GBK：
iconv('UTF-8', 'GBK//IGNORE', $text)；若用 Unicode 字体（如 Noto），保持 UTF-8 即可，但要确认 GD 编译时启用了 FreeType 2.6+ 且支持 OpenType
PHP 配置里 ttfontpath 设置无效
别信 php.ini 里那个 ttfontpath 配置项。它只在极老版本（PHP 5.2 以前）起作用，现代 PHP（7.4+）完全忽略该设置。imagettftext() 的字体路径必须显式传入第 7 个参数，PHP 不会自动拼接或 fallback。
常见误操作：
- 在 php.ini 中写了
ttfontpath = "/usr/share/fonts/truetype/simhei.ttf"，代码里却写imagettftext($im, 14, 0, 10, 30, $c, 'simhei.ttf', $text)→ 找不到，因为没带路径 - 以为设了
default_font就能省略字体参数 → 实际上imagettftext()第 7 个参数不能为空，否则直接警告并跳过绘制 - 用
getenv('FONT_PATH')动态拼路径，但环境变量未被 Apache/PHP-FPM 加载 → 建议直接硬编码或从配置文件读取绝对路径
GD 是否真正支持中文，怎么快速验证
别靠 phpinfo() 里 “FreeType Support => enabled” 就放心。那只是说明编译时链接了 FreeType 库，不代表当前运行时能加载中文字体或正确解析编码。
最简验证脚本（保存为 test-font.php 直接访问）：
<?php
$font = __DIR__ . '/fonts/simhei.ttf';
if (!file_exists($font)) die("字体文件不存在: $font");
$text = iconv('UTF-8', 'GBK//IGNORE', '测试中文');
$im = imagecreatetruecolor(300, 100);
$bg = imagecolorallocate($im, 255, 255, 255);
imagefill($im, 0, 0, $bg);
$col = imagecolorallocate($im, 0, 0, 0);
// 关键：必须传绝对路径，且字符串已转码
$r = imagettftext($im, 24, 0, 20, 50, $col, $font, $text);
if ($r === false) {
die("imagettftext 失败，请检查字体路径、编码、权限");
}
header('Content-Type: image/png');
imagepng($im);
imagedestroy($im);
?>
运行失败时看具体错误：Warning 是路径/编码问题，Fatal Error 是扩展缺失，空白图是字体无对应字形——这三类原因要分开处理，不能只改一个地方就以为全好了。
