GD扩展未启用是验证码图片空白、红叉或Network返回空响应的主因，需确认phpEnv中实际运行版本对应的php.ini，取消extension=gd注释或手动添加，并重启PHP-FPM服务；同时须清除验证码文件BOM头及前置空白。
phpEnv 中 GD 扩展未启用导致验证码不显示
验证码图片直接空白、红叉，或 Network 面板里返回空响应（Status 200 但 Response 无图像数据），大概率是 imagecreate、imagecolorallocate 等函数根本不可用 —— 这说明 phpEnv 当前 PHP 版本的 GD 扩展压根没加载。
phpEnv 和 XAMPP/WAMP 不同，它为每个 PHP 版本维护独立的 php.ini，且默认可能禁用 GD。不能只改一个 ini 文件就完事。
- 先确认你实际运行验证码脚本的是哪个 PHP 版本（比如 7.4、8.1），在 phpEnv 主界面看「当前版本」或查
phpinfo()输出里的 «PHP Version» 和 «Loaded Configuration File» 路径 - 打开对应版本的
php.ini（路径类似D:\phpenv\versions\8.1.22\php.ini），搜索extension=gd - 如果找到的是
;extension=gd或;extension=php_gd2.dll，删掉前面的分号；如果整行不存在，就在[extensions]段落末尾手动添加extension=gd（Windows）或extension=gd.so（Linux/macOS 兼容模式下） - 保存后，**必须重启 phpEnv 的 PHP-FPM 服务**（不是点「重启 Apache」，而是右键托盘图标 →「Restart PHP-FPM」），否则配置不生效
验证码脚本开头有 BOM 或空白字符
哪怕只多一个 UTF-8 BOM 字节，浏览器收到的响应就变成「text/html + 乱码二进制」，图像解析直接失败 —— 这在 phpEnv 下尤其常见，因为 Windows 用户常误用记事本保存 PHP 文件。
验证方式：用 Notepad++ 或 VS Code 打开你的验证码文件（如 captcha.php），看右下角编码是否显示「UTF-8-BOM」；或者用命令行执行 xxd captcha.php | head -1，若输出含 ef bb bf 就是 BOM。
立即学习“PHP免费学习笔记（深入）”；
- 在编辑器中将文件编码转为「UTF-8 无 BOM」，再保存
- 确保文件第一行就是
<?php，前面**不能有任何空格、换行、注释或 HTML 标签** - 加一句
if (headers_sent($file, $line)) { die("Headers already sent in $file on line $line"); }放在header()前，能快速暴露哪行偷偷输出了内容
GD 功能不全：imagecreatefrompng 报错或静默失败
即使 extension=gd 启用了，phpEnv 容器里也可能缺底层依赖库（如 libpng、freetype），导致读取 PNG 背景图或调用 imagettftext 写字体时失败，脚本中断却不报错 —— 页面就剩个空 img 标签。
典型表现：验证码能生成，但文字不显示、背景图缺失、或整个图片是纯色块；错误日志里没有 PHP Fatal，只有警告如 «failed to open stream: No such file or directory»。
- 检查验证码代码里是否用了
imagecreatefrompng()、imagecreatefromjpeg()或imagettftext()；如果用了，就得确认对应格式支持 - 访问
phpinfo()页面，搜索 «PNG Support»、«JPEG Support»、«FreeType Support»，三者都应显示 enabled - 若任一为 disabled，说明 phpEnv 的 PHP 编译时没链接对应库 —— 此时换用更完整的发行版（如官方 Windows Binaries）或改用
imagestring()绘制简单字母，避开字体依赖
session 或缓存干扰导致验证码 URL 返回 302/404
有些 phpEnv 搭配 Nginx 的配置会把 /index.php/captcha 这类 PATH_INFO 请求重写丢弃，或者 session_start() 失败后触发错误跳转，结果浏览器请求的是一个跳转地址而非图片本身。
直接在浏览器地址栏输入验证码脚本完整路径（如 http://localhost/captcha.php）看能否单独打开；如果打不开，Network 面板里 Status 显示 302 或 404，问题就不在 GD，而在路由或 session 初始化。
- 临时在验证码脚本顶部加
error_reporting(E_ALL); ini_set('display_errors', '1');，看是否有 session 相关 warning（如 «session_start(): Failed to initialize storage module»） - 检查
session.save_path是否指向一个真实存在且 phpEnv 进程有写权限的目录（如D:\phpenv\tmp\sessions） - 避免在验证码脚本里引入框架入口（如
require 'thinkphp/start.php'），它可能提前发送 header 或开启 output buffering
真正卡住人的往往不是 GD 开没开，而是 BOM、路径权限、session 存储这三处细节 —— 尤其 phpEnv 默认的 tmp 目录权限容易被忽略，session_start() 失败时又不报错，结果验证码脚本执行到一半就静默退出了。
