phpEnv下需手动启用php_gd2.dll扩展：确认当前php.ini路径，检查extension_dir指向正确，取消;extension=php_gd2.dll注释，重启服务后验证GD Support为enabled且FreeType/PNG支持为true。
phpEnv 是 Windows 下常见的 PHP 集成环境（类似 XAMPP、WAMP），默认通常不启用 GD 库，导致 imagecreatetruecolor、imagecolorallocate 等函数报错或验证码图片空白。必须手动开启扩展，且要注意 phpEnv 多版本共存带来的配置路径混淆问题。
确认当前 phpEnv 使用的 php.ini 文件位置
phpEnv 可能为每个 PHP 版本维护独立的 php.ini，直接编辑错误版本的配置无效。不要假设“桌面 phpEnv 目录下的 php.ini 就是正在用的那个”。
- 在 Web 页面运行
<?php phpinfo(); ?>，搜索 “Loaded Configuration File”，看绝对路径，例如C:\phpenv\versions\8.1.22\php.ini - 检查 “PHP Extension Dir” 路径，确认
php_gd2.dll确实存在该目录下（Windows 下扩展名固定为.dll，不是gd.so或extension=gd） - 如果看到 “GD Support” 显示 disabled，说明当前加载的 ini 文件没开 GD；如果压根没这行，说明 GD 扩展文件缺失或路径不对
开启 GD 扩展的正确写法（Windows + phpEnv）
phpEnv 的 Windows 版本依赖 php_gd2.dll，不是 gd 或 php_gd.dll。注释符必须是英文分号 ;，且不能有空格。
- 用记事本或 VS Code 打开上一步确认的
php.ini文件 - 搜索
php_gd2.dll，找到形如;extension=php_gd2.dll的行 - 删掉开头的
;，改为extension=php_gd2.dll（确保没有多余空格或中文标点） - 保存文件，**不要重启电脑，只需重启 phpEnv 的 Apache/Nginx 和 PHP-FPM 服务**（通过 phpEnv 控制面板操作）
- 再次访问
phpinfo()页面，确认 “GD Support” 为 enabled，且 “GD Version” 字段可见
验证码图片输出失败的常见原因（非 GD 未启用）
即使 GD 已启用，verify_code.php 仍可能返回空白或 500 错误，多数与输出控制和字体路径有关。
立即学习“PHP免费学习笔记（深入）”；
-
header('Content-Type: image/png')前不能有任何输出（包括 BOM、空行、echo、var_dump），建议在脚本开头加ob_end_clean();清理缓冲区 -
imagettftext()绘制文字时，若传入的字体路径不存在（如'arial.ttf'在 Windows 上实际路径是C:\Windows\Fonts\arial.ttf），会静默失败——改用绝对路径或先file_exists()判断 - 使用
imagepng($img)输出时，浏览器可能因响应头缺失而下载文件而非显示，务必确保header()在imagepng()之前且无任何前置输出 - session 未启动或
$_SESSION['captcha_code']写入失败，会导致后续验证始终不通过，但不影响图片生成本身
验证 GD 是否真能处理验证码所需功能
仅看 phpinfo() 显示 GD enabled 不够，还需确认关键子能力是否就绪，比如 TrueType 字体支持和 PNG 输出。
- 运行
<?php var_dump(gd_info()); ?>，重点检查："FreeType Support" === true（否则无法用imagettftext写字）、"PNG Support" === true（否则imagepng()会失败） - 若
"WebP Support"为 false，不影响验证码，可忽略；但若"JPEG Support"false 且你用imagejpeg()，就会出错 - 最小可用验证码脚本应包含：创建画布 → 分配颜色 → 填充背景 → 绘制文字 → 输出 PNG，缺一不可；可先屏蔽干扰线/噪点，确认基础流程通再逐步加功能
最易被忽略的是 phpEnv 多版本下编辑了错误的 php.ini，以及字体路径硬编码导致 imagettftext() 静默失败——这两点占验证码调试失败案例的七成以上。
