GD库未启用是phpEnv下验证码不显示的最常见原因，需通过phpinfo()确认GD Support为enabled且版本非空，并确保php.ini中正确配置extension=gd、extension_dir路径准确、无BOM头或前置输出。
GD库没启用，是phpEnv下验证码不显示的最常见原因。 phpEnv 默认不开启 GD 扩展，且 Windows 下的扩展名、路径、PHP 版本匹配稍有偏差就会静默失败——图像不输出、浏览器报“图像因其本身有错无法显示”，但 PHP 错误日志里可能空空如也。
确认 phpEnv 中 GD 是否真正启用
不能只看 php.ini 里有没有 extension=gd，得验证运行时状态：
- 在 phpEnv 的 Web 根目录（如
D:\phpEnv\www）新建info.php，内容为<?php phpinfo(); ?> - 用 phpEnv 自带的浏览器或访问
http://127.0.0.1/info.php - 搜索
gd，重点看两处：GD Support必须为enabled，GD Version不为空；若只看到libjpeg或FreeType支持但 GD Support 是disabled，说明扩展根本没加载成功 - 注意 phpEnv 多版本共存：你改的是当前站点所用 PHP 版本的
php.ini，不是其他版本的。可在info.php页面顶部确认 “Loaded Configuration File” 路径
Windows 下 phpEnv 启用 GD 的实操要点
phpEnv 使用的是 Windows 版 PHP（非线程安全 NTS），扩展名和启用方式与常规 WAMP 不同：
- 打开对应 PHP 版本的
php.ini（例如D:\phpEnv\php\php-8.1-nts\php.ini），搜索;extension=gd或;extension=php_gd2.dll - 取消注释，**必须写成
extension=gd** —— phpEnv 的 PHP 8+ 已统一使用gd这个短名，php_gd2.dll在新版中已废弃，强行写会导致启动失败或 GD 不可用 - 检查
extension_dir路径是否正确，例如extension_dir = "D:\phpEnv\php\php-8.1-nts\ext"，确保该目录下存在php_gd.dll（不是php_gd2.dll） - 保存后，在 phpEnv 控制面板中**完全停止再启动 PHP 和 Web 服务**（仅重启 Apache 不够，php-cgi 进程可能缓存旧配置）
验证码脚本仍空白？优先排查输出污染
phpEnv 环境下常因 BOM 头或隐藏空格导致图像流被破坏，错误现象是页面一片空白或显示乱码，但 HTTP 状态码是 200：
立即学习“PHP免费学习笔记（深入）”；
- 用 VS Code 或 Notepad++ 打开验证码文件（如
verify.php），右下角确认编码是UTF-8 without BOM，不是 UTF-8 - 文件开头 **不能有任何字符**：包括空行、空格、
<?php前的换行、HTML 注释、甚至不可见的零宽空格 - 在
header('Content-Type: image/png')之前加两行强制清理：ob_clean();和flush(); - 临时在脚本开头加
if (headers_sent($file, $line)) { die("Headers sent in $file on line $line"); }，能立刻定位哪一行提前输出了内容
字体路径和函数禁用是隐藏雷区
即使 GD 启用、无输出干扰，验证码仍可能黑屏或只显示背景——问题往往出在细节：
- 如果验证码用了
imagettftext()（带字体渲染），必须提供**绝对路径**到 .ttf 文件，例如C:\Windows\Fonts\simhei.ttf；相对路径（如./font.ttf）在 CLI 模式或某些 SAPI 下会失效 - 检查
php.ini中disable_functions是否禁用了关键函数：imagecreate、imagecolorallocate、imagepng、imagettftext—— phpEnv 有时为“安全”默认禁用部分图像函数 - phpEnv 的 session 目录（如
D:\phpEnv\tmp\session）需确保可写，否则验证码值存不进$_SESSION，后续验证永远失败，但图像本身可能还能显示
真正卡住的地方，往往是 php.ini 改了却没对应重启 php-cgi 进程，或是字体路径看着对、实际文件被杀毒软件锁定。别依赖“看起来启用了”，每一步都要用 phpinfo() 和 headers_sent() 实锤验证。
