Calibre 9.9 命令行批量转换:EPUB→Kindle/Kobo/PDF 实战
如果你的电子书超过十几本,Calibre 图形界面很快就会让你点到手酸。命令行工具 ebook-convert 随 Calibre(包含 2026 年 5 月 28 日发布的 9.9.0)一同安装,是把单文件、整个文件夹、或者整座书库转成 Kindle(KFX/AZW3)、Kobo(KEPUB)、PDF 最快的方式。本教程把 macOS、Linux、Windows 上真正可用的命令、输出配置、批量循环全部走一遍。
ebook-convert input.epub output.azw3 --output-profile=kindle_fire;批量时套一层 for 循环。Kindle 用 --output-profile=kindle(KFX),Kobo 用 kobo(KEPUB),PDF 用 tablet。Calibre 9.9.0 重写了 KFX 元数据处理,KEPUB 渲染速度比 9.8 快 30%。
为什么放着 GUI 不用,非要用命令行?
Calibre GUI 转换一两本书没问题。当你文件夹里躺着 50 本 EPUB、明天都要塞进 Kindle 时,一个个点对话框就是瓶颈。命令行还能脚本化:跟 find、xargs、parallel 串起来,或者挂个 cron 监控 Dropbox/ToConvert 目录。
- 快:没有 GUI 开销。M2 Mac 上 2 MB EPUB 转 AZW3 约 3 秒。
- 可复现:每次都同一组参数,没有「上次那个勾我到底打了没」的问题。
- 能批量:一个循环搞定整座书库,睡觉时让它自己跑。
- 适合无头环境:在 NAS、树莓派、远程服务器上跑都行。
安装或验证 CLI
CLI 跟 Calibre 一起装好,不需要额外下载。macOS 和 Linux 上安装器会自动把 ebook-convert 加进 PATH。Windows 上它落在 C:\Program Files\Calibre2\ebook-convert.exe,同样加进用户 PATH。
验证安装和版本:
ebook-convert --version
# Calibre 9.9.0 [2026 年 5 月 28 日] 单本 EPUB 转 Kindle(KFX)
最小可用命令:输入、输出、加一个输出配置。新款 Kindle(Paperwhite 5 及以上、Scribe、Colorsoft)用 --output-profile=kindle,生成支持完整排版特性的 KFX。
ebook-convert "我的书.epub" "我的书.azw3" \
--output-profile=kindle \
--enable-heuristics \
--pretty-print --enable-heuristics 打开 Calibre 的智能排版修正(GUI 里叫「启发式处理」)。--pretty-print 让输出的 AZW3 在你解包调试时能直接看明白。
转 Kobo(KEPUB)
Kobo 设备吃 KEPUB——这是 Kobo 自己的 EPUB 变体,能记录阅读位置、支持字体控制。Calibre 9.9 的 KEPUB 输出比 9.8 快,而且保留了原始 CSS,侧载字体不会丢失。
ebook-convert "我的书.epub" "我的书.kepub" \
--output-profile=kobo \
--ebook-series="我的系列" \
--ebook-series-index=1 系列参数是可选的,但在 Kobo 书库视图里效果立竿见影——书会按系列自动归组排序,而不是散落成一堆单文件。
转 PDF(在笔记本或平板上读)
PDF 是电子书最差的格式(固定版面、不能重排),但要交付印刷稿件、或者阅读 App 不支持 EPUB 时还是得用。tablet 配置对应 A5 大小,kindle_fire 对应 Fire 平板的横屏阅读。
ebook-convert "我的书.epub" "我的书.pdf" \
--output-profile=tablet \
--pdf-page-margin-left=36 \
--pdf-page-margin-right=36 \
--pdf-default-font-size=12 批量转换整个文件夹(bash / zsh)
这里是 CLI 真正回本的地方。下面的循环把当前文件夹所有 EPUB 转成 AZW3(Kindle),输出到同级 kindle/ 目录。macOS 终端和任何 Linux 通用。
mkdir -p kindle
for f in *.epub; do
ebook-convert "$f" "kindle/${f%.epub}.azw3" \
--output-profile=kindle \
--enable-heuristics
done
echo "完成。已转换 $(ls kindle | wc -l) 本书。" Windows(PowerShell)等价版本:
New-Item -ItemType Directory -Force -Path .\kindle
Get-ChildItem .\*.epub | ForEach-Object {
$out = Join-Path .\kindle ($_.BaseName + ".azw3")
ebook-convert $_.FullName $out --output-profile=kindle --enable-heuristics
} 并行批量转换(GNU parallel)
ebook-convert 单本书单线程,但很乐意多进程并行跑。8 核机器上 200 本 EPUB 从 10 分钟压到 90 秒。用 brew install parallel 或 apt install parallel 装一下。
mkdir -p kepub
ls *.epub | parallel -j 4 \
"ebook-convert {} kepub/{.}.kepub --output-profile=kobo"
ls kepub/ | wc -l
# 200 加餐:用 CLI 列出 Calibre 书库
如果书已经在 Calibre 书库(metadata.db + 文件夹结构)里,用 calibredb 列出或导出,不用开 GUI。
calibredb list --library-path ~/Calibre\ Library \
--fields title,authors,tags,formats
# 200 "Project Hail Mary" [Andy Weir] [sci-fi] [EPUB, AZW3, KFX]
# 201 "The Martian" [Andy Weir] [sci-fi] [EPUB, AZW3]
# ... 没装 Calibre?浏览器里直接转
Calibre 装下来 200 MB,只想转几个文件的话杀鸡用牛刀。converter-epub.com 在你浏览器里跑同一套转换引擎——不上传服务器、不用装、绝对隐私。拖进一个 DOCX、HTML 或者 TXT,5 秒钟拿到干净的 EPUB。一两个文件的转换,这比开终端还快。
常见问题
Q:CLI 在 Windows、macOS、Linux 上行为一致吗?
A:一致。三个平台二进制都叫 ebook-convert,参数完全相同。Windows 上文件落在 C:\Program Files\Calibre2\,装的时候会自动加到用户 PATH。如果提示找不到命令,开一次 Calibre GUI,在偏好设置里点一下「设置命令行工具」。
Q:CLI 能把 KFX 转回 EPUB 吗?
A:能,但有个前提。你得先装 KFX 输入插件(把 zip 拖进 Calibre 偏好设置,装好之后 ebook-convert 就能识别)。亚马逊买的 KFX 通常带 DRM,要先去除 DRM 再转。
Q:怎么保留 Calibre 的元数据(标题、作者、系列)?
A:用 calibredb add 把书导入书库后,元数据存在 metadata.db 里。在书库内的文件上跑 ebook-convert,会自动读取并写回元数据。如果是书库外的文件,手动传 --title、--authors、--title-sort 这些参数。
Q:KFX 和 AZW3 到底差在哪?
A:AZW3 是老 Kindle 格式(每台 Kindle 都能读)。KFX 是新格式,排版更好、断字更准、字体更接近出版社印刷效果。KFX 是某些新 Kindle 功能(Word Wise、X-Ray)的硬性要求。Paperwhite 5 及以上选 KFX;老款 Kindle Touch / Keyboard 选 AZW3 更稳。
Q:能在没有显示器的服务器上跑 CLI 吗?
A:能——这恰恰是它的设计场景。ebook-convert 不碰显示器。Synology、QNAP、Unraid、树莓派、任何容器都能跑。常见模式是 cron 监控一个 incoming 文件夹,转好的书丢到 library 文件夹。
小结
ebook-convert 命令行把 Calibre 从桌面书库管理器变成可脚本化的转换引擎。单本书一行命令 EPUB→Kindle;整座书库一个四行循环批量处理。Calibre 9.9.0 重写的 KFX 和 KEPUB 输出是项目史上准确度最高的版本,新元数据处理也修掉了之前版本「作者排序错乱」的老毛病。
如果你不想装 Calibre——或者就赶着转一个文件——converter-epub.com 浏览器里直接干。不上传、不要账号、不装软件。从「我有个 DOCX」到「我有 Kindle 能读的 EPUB」,最快的一条路。