font_path必须为绝对路径，相对路径在CLI下失效；需用__DIR__拼接并确保字体文件存在、权限正确（Linux chmod 644，Windows优先用msyh.ttc）；同时启用useZh、设置zhset、GD支持FreeType。
font_path 必须是绝对路径，相对路径在 CLI 下直接失效
ThinkPHP 6/8 中设置中文验证码字体时，fontttf 或 font_path 字段填相对路径（如 ./public/fonts/simhei.ttf 或 ../public/fonts/msyh.ttc）会导致图片空白、控制台无报错但返回空响应——尤其在命令行运行（php think run）或定时任务中必现。根本原因是 GD 扩展调用 imagettftext 时，PHP 不会自动解析相对路径，而是以当前工作目录（如项目根或 think 命令所在目录）为基准查找，极易失败。
正确做法只有一条：全部用 __DIR__ 拼出绝对路径，例如：
'fontttf' => __DIR__ . '/../public/fonts/simhei.ttf', 'font_path' => __DIR__ . '/../public/fonts/msyh.ttc',
注意：__DIR__ 是配置文件所在目录（通常是 config/），所以 ../public/ 才能上溯到 Web 根目录；若你把配置写在控制器里，就得用 app_path() 或 public_path()（TP8）等辅助函数。
字体文件必须真实存在且权限可读，Windows 和 Linux 处理方式不同
即使路径写对了，如果字体文件缺失或权限不对，GD 会静默降级为位图字体（imagestring），结果就是中文变方块、乱码或只显示背景色。
立即学习“PHP免费学习笔记（深入）”；
- Linux 下：确认文件存在后，执行
chmod 644 /path/to/simhei.ttf；不要用755，GD 不需要执行权限 - Windows 下：优先用
simsun.ttc（宋体）或msyh.ttc（微软雅黑），避免用.ttf后缀的单字重字体（如simhei.ttf），部分旧版 GD 对 TTC 容器支持更稳 - 验证是否加载成功：在控制器里加一行
var_dump(file_exists($fontPath)); die;，真值才继续
中文验证码需三要素同时满足，缺一不可
只设 fontttf 不等于能出中文。ThinkPHP 的中文验证码逻辑是“开关+字符集+字体”三位一体：
-
'useZh' => true：启用中文模式（TP6 是useZh，TP8 是use_zh，注意下划线） -
'zhset' => '登录|验证|安全'：指定可选汉字池，不能留空或填中文标点以外的符号 -
'fontttf' => ...：指向真实存在的中文字体，且该字体必须支持 UTF-8 编码（simhei.ttf在某些 Linux 环境下会因编码问题显示为空白，换ukai.ttc或wqy-zenhei.ttc更稳妥）
漏掉任一条件，都会回退到默认英文数字验证码，且不报错——这是最常被忽略的静默失败点。
GD 库必须支持 TrueType，否则字体参数完全无效
即使路径、权限、配置全对，imagettftext 函数本身不可用也会让字体设置失效。检查方法很简单：
php -r "print_r(gd_info());"
重点看这两项：
-
FreeType Support→ 必须为true（不是''或false） -
FreeType Linkage→ 推荐'with freetype'，若显示'with unknown'，说明编译时没链接 freetype 库
常见修复方式：
Ubuntu/Debian：安装 libfreetype6-dev + 重新编译 PHP 或启用 gd 扩展
CentOS/RHEL：yum install freetype-devel + 重启 PHP-FPM
Windows：确保 php_gd2.dll 已启用，且系统有对应字体文件
字体路径不是“写对就行”的配置项，它是连接 PHP、GD、操作系统字体子系统和 Web 服务器权限模型的一条脆弱链路。任何一个环节松动，都会导致中文显示失败，且错误极其隐蔽——页面空白、控制台沉默、日志无记录。动手前先确认 file_exists 和 gd_info，比反复改配置高效得多。
