gd库需启用，否则验证码不显示；应优先用imagecreatetruecolor()并配合imagefill()设背景；文字尺寸须用imagettfbbox()计算；输出前须清缓冲区且header必须在最前。
GD 库是否已启用？先确认 gd_info() 返回值
很多验证码不显示，根本不是代码问题，而是 PHP 没加载 GD 扩展。运行 phpinfo() 或直接调用 gd_info() 查看返回数组里 ['GD Version'] 是否存在且非空。Windows 下常见漏掉 extension=gd（php.ini 中），Linux 下可能需要装 php-gd 包并重启 php-fpm / Apache。没这个基础，后面所有函数都会报 Call to undefined function imagecreate()。
imagecreate() 和 imagecreatetruecolor() 选哪个？
生成验证码图，优先用 imagecreatetruecolor()。它支持真彩色、抗锯齿文字、透明度控制；而 imagecreate() 只有 256 色调色板，字母边缘容易发虚或色块错乱，尤其在加噪点或倾斜文字时更明显。不过要注意：用 imagecreatetruecolor() 后，imagecolorallocate() 必须配合 imagefill() 先填底色，否则背景是黑的（不是透明）。
常见错误：
– 忘记 imagefill($img, 0, 0, $bg)，导致验证码背景为黑色
– 用 imagecolorallocate() 分配颜色前没先调用 imagecreatetruecolor()，结果颜色分配失败返回 false
验证码文字为什么总被截断或偏出画布？
核心是没算准文字尺寸。别凭感觉设宽高，用 imageftbbox()（需开启 freetype）或 imagettfbbox() 获取文字实际包围盒。例如设图片宽 120px、高 40px，但用了 24px 字体 + 倾斜，文字实际占宽可能超 140px。建议：
- 用
imagettfbbox(16, -10, 'font.ttf', $code)得到 8 个坐标点，取右下 x 减左上 x 作为宽度参考 - 图片宽度至少设为
max($bbox[2], $bbox[4]) - min($bbox[0], $bbox[6]) + 20 - Y 轴绘制位置别写死
20，改用$bbox[7] + 5（基线偏移）
输出前必须清理缓冲区，且 header 顺序不能错
验证码图一访问就空白，90% 是输出了额外空格或 warning。确保：
– 文件开头无 BOM、无空行、无 echo/var_dump
– header('Content-Type: image/png') 必须在任何输出之前（包括 session_start() 的 warning）
– 调用 ob_clean() 或 ob_end_clean() 清掉之前可能的输出缓存
– 最后只留一个输出函数：imagepng($img) 或 imagejpeg($img, null, 85)，别跟 imagedestroy($img) 混在同一行
容易被忽略的点：如果验证码脚本被 include 进其他页面，或者用了 Composer 自动加载，前面的类文件末尾多了一个换行，也会导致 header 失效。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
