PHP 8.5.5图像水印不显示的根本原因不是版本问题，而是GD未真正启用、字体路径/编码/坐标错误、PNG透明处理缺失或输出前存在BOM/空格等污染。
PHP 8.5.5 的图像水印不显示，根本原因几乎从来不是 PHP 版本本身的问题——因为 GD 扩展在 8.5.5 中完全兼容，且该版本未引入任何 GD 相关的破坏性变更。真正卡住你的，是环境、路径或输出链路上某个看似微小却致命的断点。
GD 扩展是否真启用？别信 phpinfo() 里的“enabled”字样
imagecreatefromjpeg() 或 imagettftext() 返回 false、脚本静默中断、浏览器显示“损坏的图像”，大概率是 GD 没真正干活。
-
php -r "var_dump(extension_loaded('gd'));"必须输出bool(true)，仅靠phpinfo()页面里扫一眼“GD Support: enabled”不可靠（可能只是编译时支持，运行时未加载） - Linux 下检查
extension=gd.so是否在生效的php.ini中（用php --ini确认路径），且文件真实存在 - Windows 下确认
extension=php_gd2.dll未被注释，且 DLL 文件在ext/目录下 - 重启 Web 服务（Apache/Nginx + PHP-FPM）或 CLI 环境后才生效，改完 ini 不重启等于白改
字体路径错、编码错、坐标错：imagettftext() 三连失效
中文水印空白、方块、偏移、报错 Could not find/open font，全是这三类问题叠加。
- 字体路径必须是服务器可读的绝对路径，不要用相对路径：
<strong>DIR</strong> . '/fonts/simhei.ttf'，而不是'fonts/simhei.ttf' - 字符串必须是 UTF-8 编码字节流——PHP 不做自动转码，若源文件是 GBK 保存，
imagettftext()就会传入乱码字节 - Y 坐标不是“文字顶部”，而是左下角基准点：
$y = imagesy($im) - 20是常见安全值，但更准的做法是先调imagettfbbox()算出实际高度再减
图片水印发黑、裁剪、消失：imagecopymerge() 参数和透明度没配对
PNG 水印贴上去变成黑底、边缘锯齿、整张图变灰，说明 alpha 通道被暴力丢弃。
立即学习“PHP免费学习笔记（深入）”；
- 加载水印图前必须加：
imagealphablending($watermark, false); imagesavealpha($watermark, true); -
imagecopymerge()最后一个参数是透明度（0–100），但它不自动处理 alpha 混合；若水印本身含透明，仍需上述两行配合 - 坐标和尺寸顺序极易写反：
imagecopymerge($dst, $src, $dst_x, $dst_y, $src_x, $src_y, $width, $height, $pct)，其中$width和$height是源图（水印）的宽高，不是目标图的
header() 前有半字节输出：BOM、空格、echo、var_dump 全部算数
水印逻辑全对，imagejpeg($img) 也执行了，但浏览器只显示叉或空白——八成是输出污染。
- 用十六进制编辑器或命令行检查文件开头：
head -c 10 your_script.php | xxd，若有ef bb bf就是 UTF-8 BOM - 所有 PHP 文件必须存为 UTF-8 without BOM
- 在
header()前加一句：if (headers_sent($f, $l)) { die("Headers sent at $f:$l"); }，立刻暴露哪行偷偷输出了 -
ob_clean()是临时止血，不是根治方案；源头清理（删空格、删 BOM、删调试语句）才能稳定输出
最常被忽略的，是以为“代码跑通了=功能就对了”。GD 图像流程是一条脆弱的流水线：资源加载→内存绘图→头信息→二进制输出，任一环节混入非图像字节，整条链就报废。
