黑边主因有三：透明通道未关、背景未填、裁剪起点算偏；PNG转JPG需填白底或输出PNG；GD默认黑画布需手动填色；WebP需编译时启用支持。
黑边不是参数写错了，是透明通道没关、背景没填、裁剪起点算偏了——三者占其一就出黑边。
imagecopyresampled() 的 $src_x / $src_y 算错导致黑边
常见现象：缩略图四边或单侧出现黑色条带，尤其在居中裁剪时。本质是源图裁剪区域超出了原图边界，GD 用黑色填充越界部分。
典型错误写法：$src_x = ($orig_w - $dst_w) / 2（误把目标宽当裁剪宽）
正确做法必须分两步：
立即学习“PHP免费学习笔记（深入）”；
- 先确定裁剪区尺寸（比如取短边做正方形裁剪）：
$crop_size = min($orig_w, $orig_h) - 再算起点：
$src_x = ($orig_w - $crop_size) / 2，$src_y = ($orig_h - $crop_size) / 2 - 确保
imagecopyresampled()的源宽高参数（第5、6个）和$crop_size一致，目标宽高（第3、4个）和你要创建的画布尺寸一致
PNG 透明图生成 JPG 缩略图时黑边
现象：原图是带透明背景的 PNG，缩略图里透明区域变成纯黑块。
原因：JPG 不支持透明，GD 默认用黑色填充 alpha 区域；而你又没主动覆盖这个行为。
解决路径只有两条，选一个：
- 输出为 PNG：创建画布后立即加
imagealphablending($thumb, false)和imagesavealpha($thumb, true)，最后用imagepng() - 输出为 JPG：创建画布后先用
$white = imagecolorallocate($thumb, 255, 255, 255)，再imagefilledrectangle($thumb, 0, 0, $dst_w, $dst_h, $white)填白底，之后再 copy
别用 imagefill() 填背景色——它会破坏 alpha 通道，反而加剧黑边。
GD 创建画布默认黑色背景引发的黑边
现象：非透明图（如 JPG）缩略图边缘也发黑，尤其在等比缩放+留白场景下。
原因：imagecreatetruecolor($w, $h) 创建的是全黑画布，如果缩放后图像没铺满整个画布，剩余区域就是黑的。
处理方式取决于需求：
- 要留白（如电商图统一白底）：填白底，用
imagefilledrectangle()而非imagefill() - 要等比缩放不拉伸：计算好缩放后尺寸，再用
imagecopyresampled()把缩放图贴到画布中心，但必须手动计算$dst_x和$dst_y，否则图会靠左上角，右边/下边留黑 - WebP 输出报
Call to undefined function imagewebp()：不是代码问题，是 PHP 编译 GD 时没启用 WebP 支持，检查gd_info()['WebP Support']是否为true
最容易被忽略的点：所有涉及透明图的操作，imagealphablending() 和 imagesavealpha() 必须成对出现在 imagecreatefromxxx() 之后、任何绘图操作之前；顺序颠倒或漏掉任一调用，黑边/灰边就稳稳出现。
