tp5.1“gd库未安装”实为gd扩展未启用或缺少freetype支持，需三步修复：①确认php -m | grep gd输出且extension=gd已启用；②验证gd_info()['freetype support']为true；③清缓冲、关错误显示、去bom，并用/captcha?t=1验证二进制响应。

TP5.1 报“GD库未安装”，不是真的没装，而是 PHP 没加载 GD 扩展，或虽加载了但缺少关键能力（尤其是 FreeType 支持），导致 imagettftext() 失效、验证码生成失败——页面显示空白、红叉或黑块。

你需要分三步确认并修复：

确认 GD 扩展是否真正启用且可用

• 运行命令：php -m | grep gd
  若无任何输出，说明 GD 扩展根本未加载。需检查 php.ini，确保有这一行且未被注释：
  extension=gd（Linux/macOS）或 extension=php_gd2.dll（Windows）
  修改后务必重启 Web 服务（如 sudo systemctl restart php-fpm 或 nginx/apache2）。

• 即使 php -m 显示 gd，也必须验证 FreeType 是否支持：
  php -r "var_dump(gd_info()['FreeType Support']);"
  必须返回 bool(true)。若为 false 或报错，GD 无法渲染文字，验证码必失败。

补全 FreeType 支持（常见于 Linux 和精简版 Windows 环境）

• Ubuntu/Debian：
  sudo apt install libfreetype6-dev libjpeg-dev libpng-dev
  然后重新编译或重装 GD（Docker 中常用）：
  docker-php-ext-configure gd --with-freetype --with-jpeg
docker-php-ext-install gd

• CentOS/RHEL：
  sudo yum install freetype-devel libjpeg-devel libpng-devel
  再执行 phpize && ./configure --with-freetype --with-jpeg && make && make install

• Windows 下推荐直接换用 XAMPP、WAMP Server 3.3+ 或 Laragon，它们默认集成带 FreeType 的 GD，避免手动编译踩坑。

  

  凡科AI抠图

  一款简单易用的在线AI智能抠图工具，可自动识别图片主体并快速移除背景，适合处理日常图片素材。

  下载

排除干扰，验证输出流程

• 在调用 $captcha->entry() 前加：
  ob_clean();（清空缓冲区，不是 ob_end_clean()）
  ini_set('display_errors', 'off');（屏蔽 Notice/Warning 打断图像流）

• 检查 public/index.php 及所有引入的配置文件是否含 UTF-8 BOM：用 VS Code 打开 → 右下角点编码 → 切换为 UTF-8 without BOM 并保存。

• 访问 http://你的域名/captcha?t=1，用浏览器开发者工具看 Network 请求：
  ✅ 正确响应：状态码 200，Content-Type: image/png，Response 是二进制乱码（说明图已生成）
  ❌ 错误响应：返回 HTML 页面源码、404、500 或纯空白 → 说明 GD 仍失效，或 Nginx/Apache 把 /captcha 路径错误代理给了 PHP 而非直接响应。

不复杂但容易忽略