TP6 的 think\image\Image 类不支持 crop() 方法，因其未实现；需直连 Intervention\Image\ImageManager 调用 crop()，或用 thumb() 实现居中伪裁剪。
ThinkPHP 6.0 自带的 think\image\Image 类不支持直接裁剪 —— 调用 crop() 会报 Call to undefined method think\image\Image::crop()，因为该方法根本没实现。
为什么 Image::crop() 在 TP6 里直接报错
TP6 的 think-image 扩展只是对 intervention/image 做了轻量封装，只暴露了 open()、thumb()、save() 等基础方法，crop() 被完全移除了。你看到文档或旧版 TP5 代码里有 crop(100, 100, 20, 30)，在 TP6 中一调就崩。
- 不是配置问题，也不是驱动没启，是类里压根没这个方法定义
- 哪怕你确认 GD/Imagick 已启用、
intervention/image已安装，think\Image实例仍无法响应crop() - 错误信息明确：
Call to undefined method think\image\Image::crop()，别再查 GD 权限或路径了
绕过 think\Image，用 Intervention\Image\ImageManager 真正裁剪
必须跳过 TP6 封装层，直连底层库。前提是已执行：composer require intervention/image，且 PHP 启用了 GD 或 Imagick。
- 别用
use think\Image;，改用use Intervention\Image\ImageManager; - 创建实例时显式指定驱动：
new ImageManager(['driver' => 'gd'])（推荐 GD；Imagick 更耗内存） -
make()接收的是**绝对路径**，必须是$file->getRealPath()，不是$file->getPathname()（后者可能是/tmp/phpXXXXXX） -
crop($w, $h, $x, $y)顺序固定：宽、高、起始横坐标、起始纵坐标 —— 传成crop($x, $y, $w, $h)会裁出空白图或报Invalid dimensions - 保存前建议加
encode('jpg', 85)控制质量，否则默认可能压缩过度或格式错乱
$manager = new \Intervention\Image\ImageManager(['driver' => 'gd']);
$image = $manager->make($file->getRealPath());
$image->crop(300, 200, 50, 30);
$image->encode('jpg', 85)->save('/path/to/output.jpg');用 thumb() 实现“伪裁剪”：居中切片 + 固定尺寸
如果你只是想统一输出 200×150 的缩略图（比如商品列表），不需要任意坐标裁剪，thumb() 是更安全、更 TP6 原生的选择。
立即学习“PHP免费学习笔记（深入）”；
-
THUMB_CENTER模式会先等比缩放，再从中间截取目标尺寸，不会变形，也不依赖intervention/image - 但注意：它不校验原图是否足够大 —— 若原图只有 100×80，
thumb(200, 150, Image::THUMB_CENTER)会强行放大，模糊失真 - 务必提前判断：
if ($img->width() height() - 背景填充模式（
THUMB_FILLED）需配合background('#fff')显式设色，否则默认黑底
裁剪路径、权限和格式的三个隐形雷区
即使代码逻辑全对，以下三点仍会让裁剪静默失败或返回 500：
- 保存目录不存在且没
mkdir($dir, 0755, true)—— TP6 不自动创建多级目录，save()直接抛异常 - Windows 下路径分隔符混用：
'public/images/'. $filename可能变成public\images\abc.jpg，ImageManager::make()读不到；统一用str_replace('/', DS, $path)或__DIR__ . DS . 'public' . DS . 'images' - WebP/PNG 透明图裁剪后变黑：GD 默认丢 alpha，必须在加载后立刻加两行：
imagealphablending($src_img, false); imagesavealpha($src_img, true);（若用intervention/image，它内部已处理，但你要确认版本 ≥2.7）
最常被忽略的是裁剪坐标的越界检查 —— $x + $w > $img->width() 或 $y + $h > $img->height() 会导致 GD 返回空资源，后续 save() 失败却不报具体错误，只留一个空白文件或 0 字节。动手前先 dump 一下原始尺寸和裁剪参数。
