别把 ImageMagick 当成一个“命令行版 PS”，它更像是一个能批量化、自动化处理图片的瑞士军刀。我第一次接触它是因为要给一批几百张的产品图标统一尺寸和格式，PS 里一张一张导出简直要命，用 ImageMagick 一条命令几秒钟就全部跑完了。从那以后，图片找色、裁剪、加水印、做缩略图、转格式，甚至生成简单的动图，我都优先想它。这篇东西我把安装、常用命令、易踩的坑和几种很实用的玩法一次性讲透，适合刚接触命令行的同事，也适合已经在用但想看看别人怎么玩的开发者。
1. 为什么我劝你先忘了 PS，把 ImageMagick 装起来
1.1 它到底是什么，凭什么能替代一部分 PS 工作
ImageMagick 是一套开源跨平台的命令行图像处理工具，支持超过两百种图像格式，主流的 JPEG、PNG、GIF、WebP、TIFF、SVG 都认识，甚至还能读写 PDF。你可以在终端里用一条命令完成裁图、缩放、旋转、调色、加边框、加水印、拼接画布、生成动图等一系列操作。
很多人觉得“图片处理”必须靠鼠标拖拽，命令行算什么？但你换个角度想：手工处理一张两张没问题，一旦要处理一百张、一千张呢？PS 里就算写了动作，还是要打开软件逐批跑。ImageMagick 的优势在服务器端、在自动化脚本里、在批量场景下被无限放大。我日常处理电商素材、博客配图、应用图标，基本已经不太想开 PS 了。
而且它有个杀手锏：可复现。同一张图你手工修，每次参数都可能不一样，但命令行写下来，是这个参数就是什么效果，永远不会手抖调歪。这种确定性对做素材流水线的人来说特别重要。
1.2 版本和命令命名：别被新旧版本绕晕
先说一个新手很容易卡住的问题：网上搜教程会看到两种写法，一种是convert，一种是magick。这是 ImageMagick 6 和 7 的区别，7.x 开始所有操作都可以用magick这个统一命令完成，6.x 则是历史留下来的convert/identify/composite/montage这一套。现在新装的系统如果自带 ImageMagick，多半还是 6 的路径，但新手动安装的官网版本基本都是 7。
你自己用的话，我建议直接装 7.x，统一记magick一个命令就够了。老教程里的convert在 7 里同样兼容（旧命令文件还在），但新特性肯定只在magick上体现。另外还有几个配套命令：identify看图片信息，mogrify直接减肥式修改原图，montage拼图，compare对比两图差异。这些后面都会用到。
1.3 一个命令的组成怎么理解
ImageMagick 的命令行基本语法，通用模板是这样的：
magick 输入文件 [处理参数列表] 输出文件拿一个实际例子拆解：
magick input.jpg -resize 800x600 -quality 85 output.jpg这里input.jpg是输入，-resize 800x600是缩放参数，-quality 85是 JPEG 压缩质量，output.jpg是输出。命令从左往右读，图像会按顺序经过一层层处理，最后写出文件。理解了这个顺序，后面看任何教程都不会慌。
有个容易忽略的点：没有输入文件时，ImageMagick 也能凭空生成图，比如生成纯色背景、渐变、验证码字母，这些是它另一类很好用的能力，后面细讲。
2. 安装那点事：各系统下的版本选择与踩坑记录
2.1 Linux 下的安装：包管理器最省心
如果你用的是 Ubuntu 或 Debian 系列：
sudo apt update sudo apt install imagemagick装完验证：
magick -version如果提示convert找不到命令，那是因为新版只装了magick，你直接用magick就行。CentOS/RHEL 系列：
sudo dnf install ImageMagickFedora 也能用同样的命令。这里要多说一句：系统包管理器里带的版本通常比你想象的旧。Ubuntu 某些持续支持的老版本系统带的还是 6.9 时代的东西，功能也够用，但如果你想尝 7 的新特性，需要去官网下载二进制包，或者用第三方仓库。我个人的建议是：如果不搞特殊格式，系统源里的版本完全够日常用；如果你要处理 HEIC、PDF、原始 RAW 这类特殊输入，那就得留意依赖库。
2.2 macOS 下安装：Homebrew 是首选
macOS 上用 Homebrew 基本是一句话的事：
brew install imagemagick想支持 HEIC（苹果的图片格式），记得把扩展装上也装一下：
brew install imagemagick --with-heic不过现在新版本的 Homebrew 公式不太一样，--with-heic这种编译选项不一定还在，更稳的做法是装完后再单独装一个libheif：
brew install libheif然后 ImageMagick 就能自动识别 HEIC。装完一样用magick -version验证。
2.3 Windows 上安装：避开某些魔改版本
Windows 上没那么多魔法，去官网下载安装包是最稳妥的。安装时有一个选项“Add application directory to your system path”，一定要勾选，这样在 CMD 和 PowerShell 里才能直接用magick。
如果你喜欢用包管理器，可以试试：
winget install ImageMagick.ImageMagick或者用 Chocolatey：
choco install imagemagick我实际用过 Chocolatey 装，完事之后magick能直接在终端里面用。不过 Windows 有一点很烦：PATH 环境变量改了以后要重新打开一个终端窗口才生效，如果输入magick提示找不到命令，先别急着怀疑装没装好，看看是不是终端没重开。
2.4 关于编译安装：除非你明确需要，否则别折腾
网上很多教程会教你源码编译：
wget https://download.imagemagick.org/archive/releases/ImageMagick-xxx.tar.xz tar -xvf ImageMagick-xxx.tar.xz cd ImageMagick-xxx ./configure make sudo make install我踩过一次坑：编译时缺了很多 delegate 库（比如没有 libpng、libjpeg、libwebp），装出来的 ImageMagick 连 PNG 都读不了，识别图片格式全靠文件扩展名硬猜，处理结果完全不对。后来我把各种libxxx-dev装齐，重新编译才算能用。
所以我的结论是：能用包管理器装就用包管理器，它能帮你把依赖一并解决。只有当你需要特定的第三方库支持、或者要在极小空间里定制裁剪功能时，再考虑源码编译。编译前务必先装齐全依赖，Linux 下大概是这样一堆：
sudo apt install build-essential libjpeg-dev libpng-dev libtiff-dev libwebp-dev librsvg2-dev libgif-dev libheif-dev liblcms2-dev这些不是一次性都必须要，但你有多少格式需求就装多少对应依赖。少了某一个，运行时不会报错，但转换该格式时会直接失败，而且报错信息还不一定指向依赖问题，挺坑的。
2.5 太大坑：Windows 路径反斜杠的问题
Windows 老用户都知道，命令行里路径常用反斜杠C:\Users\xxx。但是 ImageMagick 跟在 Linux 系工具一样，反斜杠在很多情况下被当成转义符，所以我建议你在 ImageMagick 的参数里统一用正斜杠/，Windows 也能正常识别。比如：
magick C:/Users/me/pics/input.jpg -resize 50% C:/Users/me/pics/output.jpg这样至少能少踩一个经典坑。我第一次在 Windows 上跑的时候，被identify读取不了路径搞得一头雾水，后来把路径里的反斜杠换成斜杠就全好了。
3. 最常用的五个命令：从图片转换到批量缩放的实战
3.1 格式转换与压缩：快速瘦身
最基础的操作就是格式转换。比如把 PNG 转成 JPG：
magick image.png -background white -flatten image.jpg这里有个细节：PNG 带透明通道，直接转 JPG，透明区域会变成黑色，很多人第一次转完都惊呼“怎么黑了”。加-background white -flatten意思是先把透明背景填充成白色，再合并图层，这样转出来的图才符合直觉。
批量压缩一批照片，常用这条：
magick '*.jpg' -resize 1920x1080 -quality 82 -strip output.jpg这里*.jpg要用单引号包住，交给 shell 展开之后，处理完的图片会以0.jpg、1.jpg这样的名字输出。如果想保留原来的名字，用mogrify直接改原文件，但我强烈建议永远不要在原图上跑 mogrify，先用副本测试。
-strip这个参数顺便说一下：它会去掉图片里所有的 EXIF 信息（比如拍摄设备、GPS 位置），能有效减小体积，也能保护隐私。缺点是如果拍照的人希望保留镜头参数、时间地点，这条命令会把它们全删了，用之前心里有数就行。
3.2 缩放与裁剪：最常见的需求
缩放其实有两种逻辑：一种是几何尺寸，一种是比例。
magick input.jpg -resize 800x output.jpg只给800x，意思是宽度固定 800，高度按原比例自动算。反过来只给x600，就表示高度固定 600。这个懒人写法很常用，不用你自己算宽高比。
如果你希望把图强行塞进某个尺寸，不管会不会变形：
magick input.jpg -resize 800x600! output.jpg注意这个!很危险，它是“忽略比例强制拉伸”的意思，人物照片这样玩会明显变形。
裁剪最典型的是“从中间切一刀”：
magick input.jpg -gravity center -crop 800x600+0+0 +repage output.jpg-gravity center指定裁剪中心点在图片中心；-crop 800x600+0+0是裁剪尺寸和偏移量，+0+0表示以中心点为基准不再偏移。裁剪完加一个+repage，不然图片会残留一个偏移坐标，后续处理（比如拼接）经常出问题，这个参数建议养成习惯，每次 crop 后都跟着。
还有一种很实用的操作是智能补边：把一张不规则的图片扩展成正方形，空白部分补白底或模糊背景。这个我用来做社交分享图，效果像加了“背景纸”：
magick input.jpg -resize 400x400 -background '#f0f0f0' -gravity center -extent 600x600 output.jpg-extent 600x600的意思是把画布固定为 600x600，图片居中放，四周用背景色填充。这个组合在 PS 里要折腾好几次，命令行一行搞定。
3.3 查看图片信息：identify 全家桶
拿到一张图片想确认它多大、什么格式、什么色彩空间，用identify是最快的：
identify image.jpg输出大致是：
image.jpg JPEG 1920x1080 1920x1080+0+0 8-bit sRGB 1.2MB 0.03u 0:00.007想看更详细的信息加-verbose，它会列出一整屏的元数据，包括 EXIF、像素密度、色彩配置等等。排查“为什么这张图颜色不对”的时候，identify -verbose基本是必查项。另外有一个很实用的点：identify -format "%w %h" image.jpg只输出宽和高，方便在脚本里取数值做进一步计算。
3.4 叠加文字与图片水印
给图片加文字水印是我用得最多的高级功能之一。倒不是偷懒，而是公司素材库几百张图都要统一加版权信息，用代码批量做比手工快太多。
magick input.jpg -font Arial -pointsize 72 -fill white -gravity southeast -annotate +30+30 "© 2025 MyBlog" output.jpg这段的意图是：字体 Arial、字号 72、白色、定位到右下角（southeast）、离边 30 像素，写上一串文字。中文字体要特别小心，系统里如果没装中文字体，或者字体名不对，画出来的是豆腐块。更稳的写法是直接指定字体文件路径：
magick input.jpg -font /usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc -pointsize 48 -fill 'rgba(255,255,255,0.6)' -gravity north -annotate +0+20 "内部资料，请勿外传" output.jpg这里我用rgba(255,255,255,0.6)给字体加了透明度，半透明水印比纯白的好看很多。加图片水印（比如一个 logo）用composite：
composite -gravity center -geometry +20+20 logo.png input.jpg output.jpglogo 不够大可以用-resize先把它处理到合适尺寸再拼上去，两步合在一起有点绕，现实中我会先跑一条命令生成缩小的 logo，再跑 composite。
3.5 旋转、翻转与反色：几个小但救命的参数
magick input.jpg -rotate 90 output.jpg # 顺时针旋转90度 magick input.jpg -flip output.jpg # 上下翻转 magick input.jpg -flop output.jpg # 左右翻转 magick input.png -negate output.png # 反色，黑白负片效果这几个参数比较直白，没什么好展开的，关键是记下来：以前我找某个方向翻转的按钮也要找半天，命令行里写一次脚本永远不改。
4. 玩点高级的：批量处理、图片合成与动图生成
4.1 用循环和管道把单张命令变成流水线
单张图的处理终究是玩具，真正体现 ImageMagick 威力的是和 shell 脚本配合。比如给一个目录下所有 JPG 生成 400px 宽的方形缩略图：
for f in *.jpg; do magick "$f" -resize 400x400^ -gravity center -extent 400x400 "thumb_${f%.jpg}.jpg" done解释一下关键点：-resize 400x400^是指至少一边缩放到 400，多出的部分会超出画布，再配-gravity center -extent 400x400，相当于先放大到撑满，再居中裁剪成正方形。这个组合比直接-resize 400x400强在：如果原图是 3:2 横图，直接压成 1:1 会变形，而“裁剪式缩放”不会。
如果你要并发加速，可以用 xargs 配合处理：
find . -maxdepth 1 -name "*.jpg" -print0 | xargs -0 -P 4 -I {} magick {} -resize 800x "small_{}"-P 4表示 4 个进程并行。小图够了，大图并行反而会吃满内存。我一般处理几千张图才用并行，一两百张单线程跑也就十几秒。
4.2 九宫格拼图：比你想的简单
做九宫格切割和拼接是社交媒体很常见的需求。拼图用montage：
montage 1.jpg 2.jpg 3.jpg 4.jpg 5.jpg 6.jpg 7.jpg 8.jpg 9.jpg -tile 3x3 -geometry +5+5 grid.jpg-tile 3x3指定 3 行 3 列，-geometry +5+5是每张图之间留 5 像素间距，背景默认黑。如果想留白和圆角，可以加-background white -matte -border 4 -bordercolor white。拼出来就是一张完整的九宫格大图，适合发朋友圈整版那种。
反过来，把一张大图切成九宫格，用-crop：
magick big.jpg -crop 3x3@ -set filename:base "%[base]" -quality 90 "%[filename:base]-%d.jpg"-crop 3x3@表示把图均匀分成 3x3 九块，这个符号@在 ImageMagick 里就是“按比例自动切”的意思。后面的-set filename:base "%[base]"是为了把原文件名提取出来做输出前缀，否则输出的是丑丑的-0.jpg这种。
4.3 批量水印自动化：一个稍微完整的脚本思路
我做过一个给电商图批量加半透明文字水印的脚本，每次上新图跑一遍，思路值得贴出来：
#!/bin/bash for f in product_*.jpg; do magick "$f" \ -resize "1200x1200>" \ -font /usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc \ -pointsize 60 \ -fill 'rgba(255,255,255,0.55)' \ -gravity southeast \ -annotate +40+40 "MyShop Name" \ "wm_$f" done这里>后缀是重点，-resize "1200x1200>"表示只缩小不放大。如果你原图只有 800px，这条命令不会强行拉大到 1200，非常贴心。水印的文字、位置、透明度都可以做成变量，以后想换文案只改一个地方就行。
4.4 动图生成：用静态图折腾出 GIF
ImageMagick 能把一组静态图变成 GIF 动图：
magick -delay 100 -loop 0 frame1.png frame2.png frame3.png anim.gif-delay 100是每帧间隔 100 厘秒（也就是 1 秒），-loop 0表示无限循环。这个功能用来做快速预览、做表情动图，或者把连拍的照片串成小视频，都很好用。需要提一下：如果你手里是不同尺寸的图，直接做动图会很乱，最好先统一画布，或者用-coalesce自动归一。
还能从视频抽帧（配合 ffmpeg）；把一张长图切几分做成帧；甚至用渐变图生成背景动画。我玩得不多，但每次要做简单的 loading 图都是靠它。
4.5 PDF 和 SVG：别把 ImageMagick 当成排版工具
ImageMagick 能把 PDF 的每一页转成图片：
magick -density 150 文档.pdf -quality 90 page-%d.png-density 150指渲染分辨率 150 DPI，不指定默认 72 DPI，出来的图会糊。PDF 转图依赖 Ghostscript，如果你的机器上装不完整，报错会提示缺 delegate，这个时候就要去补装 Ghostscript。
SVG 转 PNG 也比较常用：magick -background none -density 300 logo.svg logo.png。-density 300控制矢量渲染的清晰度，很多人在这一步翻车，转出来的 SVG 边缘锯齿明显，就是没设密度。注意：复杂的 SVG（比如嵌入了外部字体或脚本）ImageMagick 不一定渲染得完全一致，遇到复杂设计稿，我还是建议用专业渲染工具或者直接让前端出图。
5. 你一定会踩的坑：性能、颜色、字体和管道问题
5.1 颜色不对：十有八九是色彩空间在作怪
你拿一张手机上拍的 JPEG，用 ImageMagick 转个格式，结果在浏览器里看颜色发灰或者像过曝，大概率不是转换出问题，而是色彩配置没处理好。图像文件里通常带一个 sRGB 或者 Adobe RGB 的 ICC 描述文件，ImageMagick 默认会保留，但某些处理参数会把它弄丢。
保险做法是在处理命令里显式强调目标色彩空间：
magick input.jpg -colorspace sRGB -strip output.jpg如果原图是 Adobe RGB，转 sRGB 应该用：
magick input.jpg -colorspace sRGB -intent Perceptual output.jpg-intent是颜色渲染意图。日常发网络图，我建议统一 sRGB，如果你盲转会导致颜色更差。同样的，CMYK 印刷稿转 RGB 显示，色差很容易出现，记得先-colorspace CMYK转-colorspace sRGB。
还有一个坑：-strip会把 ICC 配置也删掉。有时你只是想删 EXIF，结果颜色也变了。我一般是先做完所有视觉处理，最后一步再-strip，避免在中间步骤删掉颜色信息。
5.2 内存与性能：大图处理别贪并行
处理几千万像素的相机大图，ImageMagick 默认会把整张图片放进内存，内存不够会去写磁盘交换分区，速度降到让你怀疑人生。可以用-limit来限制内存使用上限：
magick huge.tiff -limit memory 1GiB -limit map 2GiB -resize 2000x output.jpg这一句限制核心图像缓存最多 1GB，总映射最多 2GB，超过部分会用磁盘缓存，危险操作不会把整台机器拖垮。
另外，处理完一批文件记得清理临时缓存。ImageMagick 默认缓存目录在/tmp，写大图时临时文件很占空间。你可以通过配置或环境变量MAGICK_TMPDIR指定缓存目录，这在服务器上很重要。
5.3 策略限制：权限导致的“奇数报错”
有个最容易让人摸不着头脑的坑：convert在处理 PDF 时突然报错not authorized。这不是权限问题的“权限”，而是 ImageMagick 的安全策略。出于安全考虑，官方默认限制了某些容易触发漏洞的格式（如 PDF、MSL、MVG）的读写。解决办法是修改策略文件policy.xml，在 Linux 上通常位于/etc/ImageMagick-6/policy.xml或/etc/ImageMagick-7/policy.xml。
比如你要允许读取 PDF，找到这一行：
<policy domain="coder" rights="none" pattern="PS" />改成：
<policy domain="coder" rights="read" pattern="PDF" />改完重启服务。我遇到过一次生产环境批量生成 PDF 预览图，一直报not authorized，查了半圈发现就是 Debian 系统默认策略太严格。你在自己的电脑上可能碰不到，但丢到 Docker、服务器上时，这个坑出现概率极高。
5.4 字体问题：中文变成豆腐块不是玄学
中文乱码和豆腐块是水印功能里最常被问到的问题。大多数 Linux 系统默认只有英文字体，没有中文字体，ImageMagick 找到的默认字体渲染不出 CJK 字符，就会变成一个个方框。解决办法一是装中文字体，二是直接指定字体文件路径，二选一必杀。
sudo apt install fonts-noto-cjk然后重新跑带-font的命令，指定NotoSansCJK-Regular.ttc。另外，Mac 和 Windows 上字体名字和 Linux 完全不同，为了脚本可迁移，我建议都写成完整路径，别只写字体名。比如 Windows 里中文字体路径一般是这样：
C:/Windows/Fonts/msyh.ttcmacOS 是：
/System/Library/Fonts/PingFang.ttc写进脚本前先在原机器上测试一遍。
5.5 元数据、质量与渐进式编码
很多人不知道 JPEG 默认不是渐进式显示，网络加载时是一行行刷出来的。想让图片在网速慢时先显示模糊版再变清晰，可以：
magick input.jpg -interlace Plane -quality 80 output.jpg-interlace Plane就是渐进式 JPEG 的写法，体积可能略增，但用户体验好很多。配合-strip删 EXIF，图片体积还能再降一点。压缩 PNG 的话，可以配合png:compression-level=9：
magick input.png -strip -define png:compression-level=9 output.png这个-define前缀很灵活，像是给特定格式传递私有参数，遇到格式相关的问题多想想它。
5.6 管道输入输出：小心“假死”
ImageMagick 支持从 stdin 读、向 stdout 写，这个特性在自动化场景里很爽：
curl -s https://example.com/foo.jpg | magick - -resize 100x png:-magick -表示读 stdin，结尾png:-表示输出 PNG 写到 stdout。但这里有个隐蔽问题：如果 stdout 解析失败，比如输出和终端展示发生冲突，可能会锁住管道，表现就是“卡死”。我在脚本里用管道时，都会在末尾明确标出输出格式（比如png:-、jpeg:-），避免 ImageMagick 猜格式猜错。这是经验，不然它默认根据扩展名和内容猜，如果你输出到 stdout 没带格式前缀，出来的二进制直接糊在终端屏幕上。
6. 命令行处理图片的边界：什么时候该回来用 PS
6.1 ImageMagick 做不到的精细操作
必须承认，ImageMagick 不是万能的。它擅长的是“程序化的、确定性的、大批量的”图片处理，但要说细节修图，比如人像磨皮、抠头发丝、液化、局部光影调整，它做不了。PS 有图层、蒙版、混合模式、笔刷，这些用命令行模拟出来要么复杂到不值当，要么效果根本不对。
运行模式也限制了一些场景：它是无界面的，你没法“看见”处理过程中的中间状态，只能靠经验预览结果。所以复杂设计稿、创意海报、精细合成图，我还是会打开 PS 或者 Sketch。ImageMagick 的存在是取代掉那些繁琐而机械的劳动，而不是取代设计师的工具箱。
6.2 我的工作流划分
我把图片处理分两类：一类是“重复劳动”，比如批量转格式、批量缩略图、批量加水印、自动切图，全部交给 ImageMagick；另一类是“创造性编辑”，比如修图、合成、创意排版，留在 PS 里做。
最近做的一个小项目是自动给博客每篇文章的封面图生成统一尺寸和文字标题的预览图，逻辑大概就是拉取文章标题、渲染到模板块、输出 PNG。这套流程如果让 UI 同学用 PS 手动搞，每篇文章要 5 分钟，一百篇文章就是八小时，用 ImageMagick 脚本跑了一分半。这就是命令行工具的效率意义：它不是让你“不用学 PS”，而是让你把时间花在真正需要人的创意和判断的地方。
6.3 最后分享几个让脚本更有个性的小技巧
我个人经验里，有几个能让 ImageMagick 脚本更好用的小习惯：一是所有临时文件都放到单独目录，避免污染原图；二是每个脚本都记录好原文件备份；三是对待大批量任务，先抽出一张样本图测试输出，确认效果再跑全量。
有一回我给某套系统做图片处理接口，遇到一次颜色偏绿的诡异问题，排查半天发现是带色彩管理的缩略图流程里，源 PNG 里有一个我完全没注意的 ICC 配置，ImageMagick 默认是保留的，到了浏览器渲染多了一次转换。从那次以后，我所有输出都加上-define profile:skip=ICC来遵从调用方/二次目标的色彩标准，这个问题才算稳定下来。类似的坑在真实业务里还有很多，但每个坑都值得踩一次，踩完你的脚本就越来越成熟了。
ImageMagick 这套工具，上手之后你会越来越依赖它。下次老板扔给你一堆图说要“统一处理一下”，你先别打开 PS，试试开一个终端。
