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 怎么排查
  1. 关掉终端重开一次,PATH 只在终端启动时读一次;
  2. Linux/macOS 用 which magick、Windows 用 where.exe magick,看能不能定位到可执行文件;
  3. Windows 重新跑安装包并勾选加 PATH 的选项,或手动把安装目录加进系统环境变量 PATH;
  4. 临时验证可以直接写全路径: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 更可控。