Intervention Image 安装后 Image 类找不到需手动配置门面（Laravel 5.5+）或改用依赖注入（Laravel 8+）；中文水印乱码须指定绝对路径中文字体并校验权限；批量处理应先缩放降内存、及时 destroy()；Driver [gd] not supported 是因系统未启用 PHP GD 扩展。
Intervention Image 安装后 Image 类找不到？
常见报错是 Class 'Image' not found 或 Target class [Image] does not exist。Laravel 5.5+ 默认不自动注册门面（Facade），必须手动配置。
- 运行
composer require intervention/image安装扩展包 - 若用 Laravel 8+，无需修改
config/app.php—— 因为门面已移除支持，应改用依赖注入或直接调用静态方法 - 推荐写法：在控制器中使用
use Intervention\Image\Facades\Image;（仅 Laravel ≤ 5.4 或显式启用了 Facade 的项目） - 更现代、更安全的做法：通过容器解析，例如
$image = app('intervention.image')->make($path);
给图片加文字水印时中文乱码怎么办？
Intervention Image 底层用 GD，默认不支持中文字体路径和 UTF-8 文字渲染，直接传中文字符串会显示方块或空白。
- 必须指定真实存在的中文字体文件路径，例如
/var/www/fonts/yahei.ttf，不能只写simhei.ttf - 确保 Web 服务器用户（如 www-data）对该字体文件有读取权限
- 文字坐标建议用
width() * 0.7和height() * 0.9等相对定位，避免硬编码像素值导致偏移 - 示例代码：
$img->text('© 2024 Site', $img->width() * 0.7, $img->height() * 0.9, function ($font) { $font->file('/var/www/fonts/yahei.ttf'); $font->size(24); $font->color([255, 255, 255, 0.5]); $font->align('center'); $font->valign('bottom'); });
批量处理上传图并加水印，怎么避免内存溢出？
对大图（如 4K 照片）反复 make() + resize() + insert() 容易触发 PHP 内存限制，尤其在 CLI 或队列中。
- 用
ini_set('memory_limit', '256M')临时扩容不是根本解法，应优先降分辨率再处理 - 对原始图先做等比缩放（如宽度限制在 1200px），再加水印，视觉影响小但内存占用大幅下降
- 处理完立即调用
$img->destroy()释放 GD 资源（虽然 PHP 会自动回收，但显式调用更稳妥） - 如果走队列，建议在
handle()方法末尾加gc_collect_cycles()强制垃圾回收
Laravel 10+ 使用 Image 遇到 Driver [gd] not supported
这个错误不是插件问题，而是系统缺失 GD 扩展 —— Intervention Image 在 Laravel 10 中默认要求 GD，且不再兼容 Imagick 自动 fallback。
- 检查是否启用 GD：运行
php -m | grep gd，无输出则需安装，例如 Ubuntu 上执行sudo apt install php-gd - 重启 PHP-FPM 或 Apache：
sudo systemctl restart php8.2-fpm（版本号按实际调整） - 不要试图改
config/image.php中的driver为imagick—— Laravel 10 的 Intervention 封装已移除该驱动支持 - 确认 GD 支持 JPEG/PNG：
php -r "print_r(gd_info());"查看jpeg和png对应项是否为true
实际加水印逻辑里最容易被跳过的，是字体文件路径的绝对性与权限校验 —— 很多人本地测试 OK，上线就空白，问题八成出在这儿。
