必须同步调优ImageMagick策略文件和格式解码器才能解决高清图崩溃及格式不支持问题：需修改policy.xml中memory、area、disk等限制值，并安装webp/heic等delegate依赖，否则仅装PHP扩展无效。
直接装 imagick 扩展不能解决高清图崩溃问题——ImageMagick 本身默认限制内存和处理尺寸，PHP 调用时超出就直接 segfault 或静默失败。必须同步调优 ImageMagick 配置，否则装了也白装。
宝塔一键安装 imagick 扩展后仍报 Class 'Imagick' not found
这说明扩展没真正加载成功，常见于：PHP 版本切换后未重装、扩展目录权限异常、或宝塔误判系统类型跳过依赖安装。
- 进宝塔 → 软件商店 → 搜索你当前 PHP 版本（如
PHP 8.1）→ 点设置 → 扩展页搜imagick→ 点安装（不是“启用”） - 安装完成后务必点左侧「服务」→「重启 PHP 8.1」，不能只刷新页面
- 检查
/www/server/php/81/lib/php/extensions/no-debug-non-zts-20210902/imagick.so是否存在，不存在说明编译中途失败 - 若失败日志含
cat: /etc/redhat-release: No such file or directory，是 Ubuntu/Debian 系统被宝塔误判为 CentOS，执行sudo touch /etc/redhat-release再重试
convert -version 正常但 PHP 处理 4K 图片直接崩溃
这是 ImageMagick 的策略文件（policy.xml）在拦你。它默认把 >16MP 的图片、>512MB 的内存、>128MB 的临时磁盘全部拒绝，而一张 4K JPG 解压后轻松超 200MB 内存。
- 找到 policy 文件位置：
/usr/local/imagemagick/etc/ImageMagick-7/policy.xml（手动编译安装路径）或/etc/ImageMagick-7/policy.xml（包管理安装） - 编辑该文件，把这几行的
value="..."改大：<policy domain="resource" name="memory" value="1024MiB"/><policy domain="resource" name="map" value="2048MiB"/><policy domain="resource" name="area" value="1GB"/><policy domain="resource" name="disk" value="4GB"/> - 改完执行
sudo convert -list resource确认生效，重点看Area和Memory行 - 不建议设为
unlimited，会引发 OOM Killer 杀进程
宝塔里 PHP info 显示 imagick 已启用，但 new Imagick() 报 “no decode delegate for this image format”
这是 ImageMagick 缺少对应图像格式解码器，比如 WEBP、AVIF、HEIC —— 宝塔一键安装的 ImageMagick 默认不带这些，尤其 Ubuntu 系统。
立即学习“PHP免费学习笔记（深入）”；
- 手动编译安装时加参数：
./configure --prefix=/usr/local/imagemagick --with-webp=yes --with-heic=yes --with-jpeg=yes --with-png=yes --with-tiff=yes - Ubuntu/Debian 必须先装系统级依赖：
sudo apt install libwebp-dev libheif-dev libjpeg-dev libpng-dev libtiff-dev - 编译完运行
convert -list format | grep -i webp，有WEBP* rw+才算成功 - PHP 中用
$im = new Imagick(); $im->setFormat('webp');前，务必先确认格式支持，否则 runtime 报错无提示
最易被忽略的是：ImageMagick 的策略限制和格式 delegate 是两个独立开关，一个开了另一个关着，照样崩溃或报错。别只盯着 PHP 扩展装没装成，得一层层验到底层二进制是否真能跑通你要的图。
