imagecopyresampled()是GD库生成高质量缩略图的唯一合理选择，缩略图变形因未做等比缩放，PNG透明问题需关闭混合并开启alpha保存，WebP支持需运行时检测，模糊问题宜两步缩放，JPEG须指定质量，超大图需防内存溢出，最后务必调用imagedestroy()。
imagecopyresampled() 是 GD 库生成高质量缩略图的唯一合理选择，用 imagecopyresized() 基本等于放弃清晰度。
为什么缩略图变形或拉伸？
根本不是函数本身的问题，而是你传给 imagecopyresampled() 的尺寸没做等比约束。比如目标框是 300×200，原图是 1920×1080（16:9），你直接填 imagecopyresampled($thumb, $src, 0, 0, 0, 0, 300, 200, 1920, 1080)，GD 就只能强行把整张图“撑满”进去——结果就是人脸变宽、文字被压扁。
正确做法是先算比例：
- 取
min(300 / $orig_w, 200 / $orig_h)得到最大安全缩放比 - 用这个比乘回原图尺寸，得到实际要采样的源区域宽高：
$new_w = (int)round($orig_w * $ratio)、$new_h = (int)round($orig_h * $ratio) - 再调用
imagecopyresampled($thumb, $src, 0, 0, 0, 0, $new_w, $new_h, $orig_w, $orig_h)
如果目标是固定尺寸（如卡片图），还需额外创建画布、填背景、居中贴图——imagecopyresampled() 不负责居中，只负责重采样。
立即学习“PHP免费学习笔记（深入）”；
PNG 透明图缩略后变黑/灰边？
不是图片坏了，是 GD 默认关闭 alpha 通道保存，且混合模式开着。黑色背景是默认画布色，灰边是透明像素参与了插值计算。
必须成对使用两个函数：
-
imagealphablending($thumb, false)—— 关闭混合，避免透明像素和背景色运算 -
imagesavealpha($thumb, true)—— 开启 alpha 通道保存，否则透明信息直接丢弃
漏掉任意一个，PNG 缩略图的透明区域就会出问题。JPG 不支持透明，所以不用管这两句；但如果你把 PNG 缩略图强制输出为 JPG，就得提前决定要不要转白底：imagefilledrectangle($thumb, 0, 0, $w, $h, $white)。
WebP 缩略图报 “Call to undefined function imagewebp()”？
不是代码错，是 PHP 编译 GD 时没带 WebP 支持。Ubuntu 22.04+ 的 php8.1-gd 默认支持，但 Alpine、旧版 PHP 或自编译环境大概率不带。
验证方式只有一条命令：
php -r "print_r(gd_info());"
看输出里 webp support 是否为 true。如果不是，别硬写 imagewebp()，否则线上直接 fatal error。
稳妥做法是运行时检测：
if (function_exists('imagewebp')) { imagewebp($img, $path); }- 否则 fallback 到
imagejpeg($img, $path, 95)或imagepng($img, $path) - 别在响应头里瞎设
Content-Type: image/webp，浏览器收到 JPG 数据却当 WebP 解析，会直接报错
缩略图模糊、文字发虚、边缘锯齿？
原因常被误认为是“GD 质量低”，其实是操作链断了：大图直采小图，插值精度跟不上。
实操建议分两步走：
- 先用
imagecopyresized()快速缩小到 2–3 倍目标尺寸（比如目标 200px，先缩到 400–600px） - 再用
imagecopyresampled()在这个中间尺寸上二次采样到最终大小 - JPEG 输出务必指定质量参数：
imagejpeg($img, null, 95)，默认 75 会明显损失细节 - 超大原图（>5000px 边长）建议先用
exif_imagetype()+getimagesize()检查，必要时提前降采样防内存溢出
最后别忘 imagedestroy()：每张加载的图、每个创建的画布，都得手动销毁。GD 不自动 GC，积压多了直接 OOM。
