TP6无需安装topthink/think-image，其已内置v3.x版本，类名为thinkimageImage，需手动加载GD/Imagick驱动并推荐new实例调用。
think-image 扩展不兼容 ThinkPHP 6+，别装了
直接说结论：topthink/think-image 是为 ThinkPHP 5.x 设计的扩展，TP6 已内置 think-image 组件（实际是 topthink/think-image 的重构版），但名字相同、用法不同、包名也变了。强行安装旧版会报 Class 'thinkImage' not found 或依赖冲突。
TP6 正确引入图片处理能力的方式
TP6 不需要额外安装 topthink/think-image，它默认通过 topthink/framework 间接依赖了 topthink/think-image（v3.x），核心类是 thinkimageImage，但必须手动加载驱动（GD 或 Imagick）。
- 确认已安装 PHP GD 扩展：
php -m | grep gd，没输出就先装php-gd（Linux）或开启extension=gd（Windows） - TP6 默认不自动注册
Image门面，如需用Image::open()，需在app/common.php或服务提供者中手动绑定：Container::get('think\image\Image'); - 更推荐直接 new 实例：
$image = new hinkimageImage();，避免门面未注册导致的错误
TP5.1 安装 think-image 的实际步骤（仅限老项目）
如果还在用 TP5.1，think-image 是独立扩展，但 composer 安装后需手动注册服务提供者，否则 Image 类不可用。
- 运行：
composer require topthink/think-image - 编辑
application/provider.php，追加：thinkimageProvider::class
- 确保
config/app.php中'auto_load' => true，否则服务提供者不生效 - GD 扩展仍是硬性依赖，
imagecreatefromjpeg等函数缺失会导致call_user_func_array(): Unable to call imagecreatefromjpeg
常见报错和对应解法
很多问题其实和扩展本身无关，而是环境或调用姿势不对。
立即学习“PHP免费学习笔记（深入）”；
-
Class 'thinkImage' not found：TP6 里类全名是thinkimageImage，不是thinkImage；TP5 里没注册服务提供者也会这样 -
imagecreatefromjpeg(): failed to open stream：不是路径错，是 PHP 没开 GD，或文件权限/SELinux 阻止读取 - 缩略图变黑/空白：GD 不支持 WebP 或 AVIF 输入，而 Imagick 支持；TP6 下可改用
imagick驱动，但需先装 PHP Imagick 扩展 - TP6 使用
Image::open()报错：门面未绑定，不要依赖静态调用，改用new hinkimageImage()
真正麻烦的从来不是装哪个包，而是 GD 和 Imagick 驱动的环境适配 —— 同一份代码，在本地开发机跑通，上阿里云轻量服务器就挂，八成是 GD 缺模块或版本太老。
