jcrop仅提供坐标，圆角头像需php用gd/imagick实现遮罩或二次绘制；须按原始尺寸换算坐标、保持透明通道、注意php版本差异及webp支持。
为什么直接用 Jcrop 提交坐标却裁不出圆角头像
因为 Jcrop 只负责选区，不处理图像；裁剪逻辑必须由 PHP 的 GD 库（或 Imagick）完成，且「圆角」不是裁剪而是遮罩或二次绘制。很多人卡在这步，以为坐标传过去就能出图，结果生成的是矩形块。
-
Jcrop返回的是x、y、w、h四个整数，需原样传给 PHP，别转成百分比再算 - GD 不支持直接“圆角裁剪”，得先
imagecrop()截出矩形，再用imagefilledellipse()或蒙版方式抠圆 - 若原始图是 PNG 且带透明通道，裁剪后务必保持
imagesavealpha()和imagealphablending()开启，否则圆角边缘发灰
imagecrop() 在 PHP 7.2+ 和旧版本的写法差异
PHP 7.2 引入了原生 imagecrop()，但参数是数组而非四个独立参数；低版本只能手写 imagecopyresampled()，容易错位。
- 新版（推荐）：
$cropped = imagecrop($src, ['x' => $x, 'y' => $y, 'width' => $w, 'height' => $h]); - 旧版兼容写法：先
imagecreatetruecolor($w, $h)，再imagecopyresampled($dst, $src, 0, 0, $x, $y, $w, $h, $w, $h) - 注意：GD 的坐标系原点在左上角，
Jcrop返回的x/y可直接用，无需反转
上传大图后裁剪变形或模糊怎么办
本质是缩放和重采样时机错了。用户上传 4000×3000 的图，前端用 Jcrop 拉小预览，但 PHP 后端仍按原始尺寸裁，导致像素失真。
- 必须在服务端重新计算真实裁剪坐标：若前端把原图缩放到宽度
800px展示，而用户选中x=120，则真实x = 120 * (原图宽 / 800) - GD 默认重采样质量一般，加
imageantialias($dst, true)（PHP 8.1+）或手动用imagecopyresampled()替代imagecopyresized() - 头像输出建议固定为 200×200 或 400×400，用
imagecreatetruecolor(200, 200)再imagecopyresampled()缩放，别依赖浏览器拉伸
裁完保存为 WebP 却打不开
不是代码问题，是服务器没开 GD 的 WebP 支持，或 PHP 版本太低（imagewebp() 要 PHP 5.4+，但 WebP 编解码需 GD ≥ 2.1.0 且编译时带 libwebp）。
立即学习“PHP免费学习笔记（深入）”；
- 先检查：
var_dump(gd_info());看webp support是否为true - 没开启就 fallback 到
imagepng()或imagejpeg()，别硬用imagewebp() - WebP 质量参数是 0–100，但
imagewebp($img, $path, 80)的第三个参数在旧 GD 中会被忽略，只认imagepng($img, $path, 9)这种压缩级别
GD 处理头像真正的难点不在裁，而在保持清晰度、透明度和格式兼容性；很多坑都藏在缩放倍率换算和扩展支持检测里，漏掉一个，前端看着正常，实际保存出来糊成一片或者缺角。
