ThinkPHP 5.1 验证码不显示的根本原因是环境配置问题：GD扩展未启用或FreeType不支持、字体路径错误或不可读、输出被BOM/错误提示污染、缓存目录不可写，任一环节异常均导致空白或红叉。
ThinkPHP 5.1 验证码图片不显示，不是代码写错了，而是服务器环境缺关键组件或输出被悄悄污染——GD 库没装全、FreeType 不支持、字体路径错、BOM 头混进脚本、缓存目录不可写，任意一个都会让验证码变成空白或红叉。
确认 GD 扩展已启用且支持 TrueType
第一步：在命令行运行 php -m | grep gd，如果无任何输出，说明 GD 扩展根本没加载。
第二步：运行 php -r "var_dump(gd_info()['FreeType Support']);"，必须看到 bool(true)；若为 bool(false)，【imagettftext() 将彻底失效，验证码必然空白】。
Linux 下补 FreeType 支持：Ubuntu/Debian 执行 sudo apt install libfreetype6-dev，CentOS 执行 sudo yum install freetype-devel；PHP 若为源码编译，重编时必须加 --with-freetype（新版不再认 --with-freetype-dir）。
立即学习“PHP免费学习笔记（深入）”；
清除输出缓冲并屏蔽干扰输出
方法一：在控制器中生成验证码前插入 ob_clean(); —— 这是 ThinkPHP 官方文档明确推荐的修复手段，不是可选项。
方法二：在验证码方法开头加 ini_set('display_errors', 'off');，防止 Notice 或 Warning 混入图像流。
方法三：检查 public/index.php 和验证码所在控制器文件是否含 UTF-8 BOM —— 用 VS Code 打开 → 右下角编码显示 “UTF-8 with BOM” 时，点击切换为 “UTF-8 without BOM” 并保存。
注意：不要用 ob_end_clean() 替代 ob_clean()，前者会关闭缓冲区，后者才清空内容但保持开启状态，这才是验证码需要的。
验证字体文件存在性与权限
TP5.1 默认使用 think\captcha\assets\font\1.ttf，先确认该文件真实存在：ls -l think/captcha/assets/font/1.ttf。
若文件存在但仍是空白图，大概率是 Linux 下无法读取该字体 —— imagettftext() 对中文路径、空格路径、带 BOM 的文件名极度敏感，【绝对不要用 simhei.ttf 等 Windows 字体】。
换成开源无版权的 DejaVuSans.ttf（从 fonts.google.com 下载），放到 public/static/font/ 目录，再在配置中显式指定：'font' => public_path('static/font/DejaVuSans.ttf')。
最后确保 Web 进程用户（如 www-data 或 nginx）有读权限：chmod 644 public/static/font/DejaVuSans.ttf。
检查 runtime/cache/captcha 目录可写
第一步：进入项目根目录，执行 ls -ld runtime/cache/captcha，确认目录存在且权限包含 w（如 drwxr-xr-x 表示不可写，需修复）。
第二步：若目录不存在，手动创建：mkdir -p runtime/cache/captcha。
第三步：赋予 Web 用户写权限：chown -R www-data:www-data runtime/cache（Ubuntu/Debian）或 chown -R nginx:nginx runtime/cache（CentOS）。
第四步：确认磁盘未满，df -h 查看 /var 或项目所在分区剩余空间。
