thinkphp6默认不内置图片处理能力，必须安装topthink/think-image扩展；image::open()仅接受真实文件路径，不支持uploadedfile对象；thumb()支持scale、filled、fixed三种缩略模式，推荐使用filled避免变形。
ThinkPHP6 默认不内置图片处理能力，必须手动安装 topthink/think-image 才能生成缩略图；GD 库是底层依赖，但你不需要单独配置 GD —— 只要 PHP 环境已启用 gd 扩展（绝大多数主机默认开启），think-image 就能自动用它工作。
为什么 Image::open() 报错 “Unsupported image type”
常见于直接传入 $_FILES 临时文件路径或 Request::file() 对象本身，而不是实际保存后的文件路径。
-
Image::open()只接受本地磁盘上的真实文件路径（如public/uploads/20260509/abc.jpg），不接受UploadedFile实例或tmp_name - 必须先用
Filesystem::disk('public')->putFile()或$file->move()把文件落地，再把返回的相对路径拼成绝对路径传给Image::open() - 错误写法：
Image::open($request->file('img'))→ 直接报错 - 正确写法：
Image::open(public_path() . '/uploads/' . $savedName)
thumb() 的三个参数模式怎么选
thumb() 支持三种裁剪/缩放策略，对应 think\Image 的常量，行为差异极大，选错会导致图片被拉伸、留黑边或只截中间一小块：
-
IMAGE_THUMB_SCALE（默认）：等比缩放，不裁剪，可能宽高不匹配目标尺寸（比如原图 800×600 缩成 100×100，结果是 100×75） -
IMAGE_THUMB_FILLED：等比缩放后居中填满，空白处用背景色填充（默认黑，可用第 4 参数改） -
IMAGE_THUMB_FIXED：强制拉伸到指定宽高 —— 不推荐，会严重变形 - 常用组合：
$image->thumb(200, 200, \think\Image::IMAGE_THUMB_FILLED)->save($thumbPath)
缩略图路径和权限问题最容易卡在哪
不是代码写错，而是目录不存在或没写入权限 —— 尤其在 Linux 生产环境：
-
putFile()和save()都依赖目标目录可写，public/img/thumb/这类自定义路径必须手动创建（mkdir -p public/img/thumb） - 不要用
date('Ymd')拼路径却忘了file_exists()+mkdir()判断，否则第一次请求必失败 - 别把缩略图存到
storage/下再通过 URL 访问 ——storage默认不公开，得配软链或改 Web 根目录 - 推荐路径结构：
public/uploads/原始图+public/thumbs/缩略图，两者都可通过 HTTP 直接访问
真正麻烦的是并发上传时用 time().rand() 生成文件名仍可能撞车，且 md5() 不解决重复内容问题；如果业务对唯一性敏感，应该用 uniqid('', true) 或数据库主键+时间戳拼接，而不是只靠随机数。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
