imagemagick 是干什么的
ImageMagick 是一套命令行图片处理工具:不打开修图软件,一条命令就能缩放、裁剪、旋转、转格式、压缩、加水印,还能一次处理整个目录的图片。
$ magick identify logo.png
logo.png PNG 800x600 800x600+0+0 8-bit sRGB 123456B 0.000u 0:00.001
$ magick logo.png -resize 50% logo-half.png
$ magick identify logo-half.png
logo-half.png PNG 400x300 400x300+0+0 8-bit sRGB 45678B 0.000u 0:00.001
800×600 的图跑一条 -resize 50% 就变成 400×300,原图不动、新图另存。它所有命令只有一种形状:magick 输入图 一串操作 输出图,操作从左到右依次生效,最后一个参数决定写到哪个文件、以什么格式写。
批量降图、把设计稿 PNG 转成网页用的 WebP、给截图加水印、把 PDF 拆成一张张图,这类「用脚本一次跑完」的活都是它的主场。
这一页的命令在哪执行
在 Linux / macOS / WSL 的终端里直接跑;Windows 的 PowerShell 和 CMD 也能跑,前提是安装时把 ImageMagick 目录加进了 PATH。
第一步先确认装的是第几版,这决定下面每条命令用 magick 还是 convert:
$ magick -version
ImageMagick 7.1.1-30 Q16-HDRI x86_64 2024-01-01
$ convert -version
Version: ImageMagick 6.9.11-60 Q16 x86_64 2021-01-25
第一条打出版本号就是 7.x,本页命令原样用;只有第二条能跑就是 6.x,把 magick 换成 convert、magick identify 换成 identify。 两条都提示找不到命令,是没装或没进 PATH。
装法:Ubuntu/Debian 用 sudo apt install imagemagick;macOS 用 brew install imagemagick;Windows 去官网下安装包,安装向导里勾上 “Add application directory to your system path”,装完重开终端。
展开:装了却提示 command not found 怎么排查
- 关掉终端重开一次,PATH 只在终端启动时读一次;
- Linux/macOS 用
which magick、Windows 用where.exe magick,看能不能定位到可执行文件; - Windows 重新跑安装包并勾选加 PATH 的选项,或手动把安装目录加进系统环境变量 PATH;
- 临时验证可以直接写全路径:Linux 常见
/usr/bin/magick,Windows 常见C:/Program Files/ImageMagick-7.1.1-Q16-HDRI/magick.exe。
ImageMagick 到底在干什么
一、7 和 6 是两套命令,先分清
ImageMagick 7 把大部分功能收进一个 magick 主命令,ImageMagick 6 是每个功能一个独立命令。同一个动作,两版写法不同:
| 动作 | 7.x 写法 | 6.x 写法 |
|---|---|---|
| 处理图片 | magick 输入 选项 输出 |
convert 输入 选项 输出 |
| 看图片信息 | magick identify 图.png |
identify 图.png |
| 批量原地处理 | magick mogrify 选项 文件 |
mogrify 选项 文件 |
| 叠加 / 水印 | magick composite ... |
composite ... |
| 拼图 | magick montage ... |
montage ... |
| 看版本 | magick -version |
convert -version |
7 里 convert 仍然能用,但它只是兼容入口,官方建议新命令一律写 magick。Windows 上还要多留个心眼:系统自带一个 convert.exe(FAT 转 NTFS 的工具),不写全路径时敲 convert 很可能调起它,报出“参数无效”这类莫名其妙的错误——这不是命令写错,是跑到了别的程序。
二、一条命令就是一条流水线
输入图读进来后,按书写顺序依次执行每个操作,后一个操作看到的是前一个操作的结果,最后按输出文件的扩展名决定格式写盘。
$ magick logo.png -resize 800x -crop 400x300+0+0 +repage -quality 85 out.jpg
这条依次做了四件事:宽度缩到 800(高等比算)→ 从左上角裁 400×300 → 重置画布偏移 → 以 JPEG 质量 85 写出。顺序一换结果就不同:先 -crop 再 -resize,裁的是原图那块区域再缩一次,最终尺寸和内容都不一样。
三、尺寸写法:50%、800x600、800x 各是什么意思
| 写法 | 含义 | 1600×1200 的图处理完 |
|---|---|---|
50% |
宽高都乘 0.5 | 800×600 |
800x600 |
等比缩进 800×600 的框,不拉伸 | 800×600 |
800x |
宽固定 800,高按原比例 | 800×600 |
x600 |
高固定 600,宽按原比例 | 800×600 |
800x600! |
强制 800×600,比例不符就变形 | 800×600(可能被拉扁) |
800x600> |
只在原图更大时缩,小图不放大 | 800×600 |
800x600< |
只在原图更小时放大 | 800×600 |
只写宽度 800x 是最常用的写法:不关心高度,让高度自己按比例算出来,永远不会变形。-resize 800x600 不带感叹号是“装进框里”,不是“拉伸成 800×600”——1600×900 的图处理完是 800×450,高度没占满但比例保住了。
默认会放大:400×300 的图跑 -resize 800x600 也会变大,体积上去、清晰度不会变好,批量处理小图时加 > 更安全。
四、几何参数是「宽x高+左偏移+上偏移」
-crop 400x300+100+50 的意思是:从距离左边 100、距离上边 50 的位置开始,取一块 400×300。原点在左上角,x 向右变大、y 向下变大,和数学坐标系上下相反。
裁剪完通常要接 +repage:-crop 会把“这块图在原图里的偏移”记进元数据,PNG / GIF / WebP 会保留它,某些查看器和后续拼图会按偏移摆放,看起来“裁完位置不对”。+repage 把偏移清零,输出就是一张干净的独立图。 JPEG 不保存这个偏移,所以有时看不出问题,但不能因此省略。
语法骨架
magick 输入文件 [选项 参数 ...] 输出文件
- 输入、输出都可以写多个;不写输出文件、只接管道时用
-或png:-; - 操作按顺序生效,同一个选项写两次通常以最后一次为准;
- 格式默认由输出扩展名决定,也可以用前缀强写:
jpg:out.bin写出的是 JPEG 内容。
常用选项:
| 选项 | 作用 | 说明 |
|---|---|---|
-resize 800x |
缩放 | 写法见上一节的表 |
-crop 400x300+100+50 |
裁剪 | 后面接 +repage 清偏移 |
-rotate 90 |
旋转 | 正数顺时针,负数逆时针 |
-flip / -flop |
上下 / 左右翻转 | 不改变画布尺寸 |
-quality 85 |
压缩质量 | 主要对 JPEG 生效,1–100 |
-strip |
去元数据 | 删 EXIF / ICC / 内嵌缩略图 |
-gravity southeast |
定位基准 | 水印、文字定位靠它 |
-composite |
叠加 | 前一张做底,后一张叠上去 |
-append / +append |
纵向 / 横向拼接 | 加号是横向,不加是纵向 |
identify 的格式化占位符:
| 占位符 | 含义 |
|---|---|
%w / %h |
宽 / 高(像素) |
%m |
格式名,如 PNG、JPEG |
%b |
文件体积,如 123456B |
%f |
文件名 |
输入从哪来:写文件名读文件;写 - 读标准输入,所以能接管道。找不到文件会报 unable to open image 并以非 0 退出;但尺寸参数写成不认识的值时往往不报错、直接忽略,处理完发现尺寸没变,先回头检查参数拼写。
常见用法示例
示例目录 ~/imgdemo:logo.png 是 800×600 的图标,photo.jpg 是一张照片,wm.png 是带透明背景的水印,a.png / b.png / c.png 是三张待拼接的图,doc.pdf 是两页的 PDF。$ 开头的行是输入,后面是输出。
1. 先看清手上是什么图
$ magick identify logo.png
logo.png PNG 800x600 800x600+0+0 8-bit sRGB 123456B 0.000u 0:00.001
$ magick identify -format "%m %wx%h %b" logo.png
PNG 800x600 123456B
$ magick identify -verbose photo.jpg
执行前:只知道“是一张图”。执行后:格式、宽×高、画布偏移、色彩空间、体积一次看清。
第一行里 800x600 出现两次,前面是图片尺寸,后面是画布尺寸,带 +0+0 的是偏移;两者不一样说明这张图之前被裁过却没 +repage。-verbose 会打出 EXIF、DPI、色彩配置等全部信息,排查“图为什么很糊”(DPI 太低)就用它。
2. 按百分比缩放
$ magick logo.png -resize 50% logo-half.png
$ magick identify -format "%wx%h" logo-half.png
400x300
执行前:800×600。执行后:400×300,宽高同比例减半。
50% 适合做缩略图、把 @2x 图降回 1x。想放大写 200%,但位图放大会糊,能拿到原图就别放大。
3. 缩进指定框里:800x600 与 800x
$ magick photo.jpg -resize 800x600 photo-box.jpg
$ magick photo.jpg -resize 800x photo-w.jpg
$ magick photo.jpg -resize 800x600! photo-force.jpg
执行前:photo.jpg 是 1600×1200。执行后:photo-box.jpg 是 800×600;同一张图如果跑 800x600 而原图是 1600×900,结果会是 800×450;photo-w.jpg 宽度一定是 800;photo-force.jpg 一定是 800×600,比例不对就被压扁。
只写宽度 800x 和写全 800x600 的区别就在这:前者高度跟着比例走,后者是“塞进框里”,高度可能小于 600。做网页配图通常只约束宽度,写 800x 最省心。
4. 裁剪一块区域并清掉偏移
$ magick photo.jpg -crop 400x300+100+50 +repage crop.jpg
$ magick identify -format "%wx%h" crop.jpg
400x300
执行前:1600×1200 整图。执行后:从 (100,50) 开始的 400×300 一块。
去掉 +repage 后 PNG 输出会带着 +100+50 的偏移,在部分查看器里显示成“一张大画布上偏右下角的小图”,拼图时也会错位。裁剪区域超出原图边界时 ImageMagick 不报错,而是切成多张,输出变成 crop-0.jpg、crop-1.jpg;只想要一张就先把坐标算好。
5. 旋转
$ magick photo.jpg -rotate 90 rot90.jpg
$ magick photo.jpg -rotate -90 rot-90.jpg
$ magick photo.jpg -background none -rotate 45 rot45.png
执行前:横图 1600×1200。执行后:rot90.jpg 变成 1200×1600(顺时针 90°);rot-90.jpg 是逆时针 90°;rot45.png 斜 45°,画布自动扩大,空出来的角用背景色填充。
-rotate 90 是顺时针、负数是逆时针,记不住就记“正数往右倒”。非 90 度倍数会扩大画布,默认白色填充;想要透明必须 -background none 且输出 PNG / WebP,写 JPEG 一定没有透明(透明区域会变黑或变白)。只是纠正手机照片方向,用 -auto-orient 比手写角度可靠。
6. 格式转换
$ magick logo.png logo.webp
$ magick logo.png -background white -flatten logo.jpg
$ magick photo.jpg photo.png
执行前:logo.png 带透明背景。执行后:logo.webp 保留透明;logo.jpg 没有透明通道,透明区域按当前背景色填充,不写 -background white -flatten 时常见结果是黑底,这是 PNG 转 JPG 最常见的翻车点。
格式由输出扩展名决定,不用额外写参数;需要精确控制编码器时再显式指定。
7. JPEG 质量压缩
$ magick photo.jpg -strip -quality 75 -sampling-factor 4:2:0 small.jpg
$ ls -l photo.jpg small.jpg
执行前:原图可能 2 MB。执行后:尺寸不变,体积通常降到几百 KB。
-quality 75:JPEG 质量,1 最差 100 最好,默认约 92;网页图常用 75–85,肉眼基本看不出差别;-strip:删掉 EXIF、ICC 配置和内嵌缩略图,能再省几十 KB,代价是丢失拍摄信息和色彩配置;-sampling-factor 4:2:0:色度抽样,进一步减体积,纯色块多的图边缘可能发糊;- 质量不是越高越好:
-quality 100体积反而可能比原图更大,画质却看不出提升。
PNG 的 -quality 含义不同(映射到压缩级别与过滤方式),要压 PNG 用 -define png:compression-level=9,或者干脆转 WebP。
8. 批量处理:先备份,或者输出到新目录
mogrify 会直接覆盖原文件,没有确认、没有回收站、没有撤销。 动手前二选一:
# 做法一:先整目录备份,再原地处理
$ cp -r imgs imgs.bak
$ magick mogrify -resize 1200x -quality 85 imgs/*.jpg
# 做法二:不备份,把结果写到另一个目录(推荐)
$ mkdir -p out
$ magick mogrify -path out -resize 1200x -quality 85 imgs/*.jpg
执行前:imgs/ 里是十几张 3000px 宽的原图。执行后:做法一里 imgs/ 的图被替换成 1200px 宽、质量 85 的版本,imgs.bak/ 留有原图;做法二里 imgs/ 一个字节没动,缩好的图全部出现在 out/ 下,文件名不变。
-path out是 mogrify 唯一的“安全阀”,加上它就不会动原文件;- 通配符匹配不到文件时 mogrify 会报
no images defined,先ls imgs/*.jpg确认路径; -format jpg能让 mogrify 输出另一种格式(扩展名不同,原文件因此保留),但它仍然写在同一目录,混着用容易乱;- 实在要原地改又没有备份,先跑一遍
mkdir check && magick mogrify -path check 参数 文件,看输出对不对再决定去掉-path。
9. 加水印 / 叠加图层
$ magick photo.jpg wm.png -gravity southeast -geometry +20+20 -composite out.jpg
执行前:photo.jpg 无水印,wm.png 是带透明背景的 PNG。执行后:水印出现在右下角,距右、距下各 20px。
- 前一张是底图,后一张是要叠上去的图,
-composite把当前两张合成; -gravity southeast指定基准角(右下),也可用northwest、center等;-geometry +20+20是相对基准的偏移;- 想半透明加
-dissolve 40%,想换位置就换 gravity; - 批量加水印用循环,输出目录要先建好:
$ mkdir -p out
$ for f in *.jpg; do magick "$f" wm.png -gravity southeast -geometry +20+20 -composite "out/$f"; done
水印图比底图还大时 -composite 只叠进底图范围、不会报错,结果是整张图被水印盖住——先把水印缩小。
10. 多图拼接
$ magick a.png b.png c.png +append row.png
$ magick a.png b.png c.png -append col.png
$ magick montage a.png b.png c.png -tile 3x1 -geometry +4+4 sheet.png
执行前:三张尺寸相同的图。执行后:row.png 横向排成一行;col.png 纵向排成一列;sheet.png 是三列网格,图与图之间留 4px 间距。
+append 是横向(加号像横着排),-append 是纵向,这个符号最容易记反。三张尺寸不一致时,直接拼接按最大宽/高对齐,短的那张留白;montage 更智能,会自动排网格并支持 -background 设底色。
11. PDF 转图片:默认会被安全策略挡住
$ magick -density 150 "doc.pdf[0]" page1.png
magick: attempt to perform an operation not allowed by the security policy PDF @ error/constitute.c/ReadImage/904.
执行前:想取 PDF 第一页转成 150 DPI 的 PNG。执行后:报上面那条错,一张图都没生成。
这不是命令写错,是 ImageMagick 7.1.1 起默认的安全策略禁止解析 PDF / PS / EPS——PDF 解析要交给 Ghostscript,历史上出过远程执行漏洞。三条路:
# 1) 先确认当前策略
$ magick -list policy
# 2) 推荐:用 poppler 的 pdftoppm,不碰 ImageMagick 的策略
$ pdftoppm -png -r 150 doc.pdf page
# 3) 确认文件来源可信后,改 policy.xml 放开 PDF(生产环境不建议)
# Linux: /etc/ImageMagick-7/policy.xml
# Windows: ImageMagick 安装目录下的 policy.xml
另外 -density 必须写在输入文件之前,写在后面只改元数据、不影响光栅化精度。
容易踩的坑
版本差异:先看版本再抄命令
- 抄来的命令报
magick: command not found→ 装的是 6.x,把magick换成convert、magick identify换成identify; - Windows 上敲
convert报奇怪的参数错误 → 调到了系统的convert.exe,改用magick或写全路径; - 同一份脚本在两台机器上结果不同,多半一台 6 一台 7,脚本里先
magick -version打一行日志。
mogrify 覆盖:没有撤销
mogrify默认原地改写,没有确认提示,参数写错就是一目录的图全毁;- 养成习惯:先
cp -r备份,或者一律加-path 输出目录; - 用
find拼出的文件清单跑 mogrify 时尤其危险,路径范围写错很难恢复。
PDF 安全策略:报错不是命令错
- 报
not allowed by the security policy就是策略拦截,不是语法问题; - 默认情况下 PDF / PS / EPS 都在禁止名单里,改
policy.xml有安全风险; - 本地可信文件用
pdftoppm绕开即可,服务器上别为了图省事关掉策略。
中文路径与文件名
- 路径里有空格或中文,一律用引号包住:
magick "D:/素材/截图 1.png" -resize 800x out.png; - Linux 下先确认
locale输出里有UTF-8,否则中文名可能读不到; - 老版本 Windows 构建对非 ASCII 路径支持不完整,报“找不到文件”时可以先把图复制到纯英文目录处理;
- 中文文字水印必须指定中文字体,否则渲染成方块或问号:
-font "C:/Windows/Fonts/msyh.ttc";Linux 装fonts-noto-cjk后用-font Noto-Sans-CJK-SC,可用magick -list font查已装字体。
失败对照:现象、原因、处理
| 现象 | 原因 | 处理 |
|---|---|---|
unable to open image |
路径错、没权限、中文或空格没加引号 | 用 ls 确认路径,参数加引号 |
no images defined |
通配符没匹配到文件 | 先 ls *.jpg 确认目录和扩展名 |
not authorized / security policy |
policy.xml 禁止了该格式 | 换 pdftoppm 等专用工具,不要直接关策略 |
no decode delegate / no encode delegate |
这个构建缺少对应格式的支持库 | 装对应 delegate(如 WebP、HEIC),或换一种格式 |
| 处理后尺寸没变 | 尺寸参数拼错(大小写、缺 x) |
检查写法,注意单位与大小写 |
| PNG 转 JPG 后背景变黑 | 透明区域没有铺底色 | 加 -background white -flatten |
裁剪结果出现多张 -0、-1 |
裁剪区域超出原图边界 | 缩小裁剪范围,或接受分块输出 |
| 拼接后图错位 | 没加 +repage,偏移还在 |
裁剪后补 +repage 再拼 |
| 中文水印变成方块 | 没指定中文字体 | -font 指向 msyh.ttc 或 Noto CJK |
| 批量处理把原图改坏 | mogrify 原地覆盖 |
从备份恢复,下次加 -path |
什么时候不该用 ImageMagick
- 要精确排版、图层、蒙版:用设计工具,命令行拼这些很痛苦;
- 只想要极致压缩:JPEG 用
mozjpeg、WebP 用cwebp、AVIF 用avifenc,同画质体积更小; - 处理视频:用
ffmpeg; - 只改 EXIF / 时间 / 地理位置:用
exiftool,ImageMagick 只能整体删掉; - 批量逻辑复杂到要判断、要读配置:写成 Python(Pillow)或 Node(sharp)脚本,比堆 shell 更可控。