Calibre 电子书转换教程：从命令行到图形界面的完整流程

Calibre 电子书转换教程：从命令行到图形界面的完整流程

【免费下载链接】calibreThe official source code repository for the calibre ebook manager项目地址: https://gitcode.com/GitHub_Trending/ca/calibre

calibre 是开源电子书管理套件，核心能力是把几乎所有主流电子书格式互相转换，并顺带管理整个书库。读完本文，你能从源码跑起 calibre，完成一次标准格式转换，并掌握结构检测、排版定制这类进阶玩法。

🔌 为什么你需要电子书格式转换

书源格式五花八门：从网站下到 RTF、FB2，同事发你 EPUB，Kindle 只认 AZW3，手机 App 又要 MOBI。与其到处找"已转好的版本"，不如自己转。

calibre 的转换引擎是一条流水线：先由输入插件把源文件解析成 XHTML，中间执行一堆标准化变换（生成目录、调整字号、压缩图片），最后由输出插件打包成目标格式。你在转换对话框里调的每个选项，都对应这条流水线上的某个环节。

# 一句话的用法预告：源文件转目标格式 ebook-convert input.rtf output.epub

📦 从源码安装 calibre 并启动

获取源码并初始化

git clone https://gitcode.com/GitHub_Trending/ca/calibre # 克隆源码仓库 cd calibre sudo python setup.py bootstrap # 把 git 源码补齐为可构建状态 sudo python setup.py develop # 以开发模式安装入口命令

用 run-local 启动转换与界面

仓库根目录的run-local启动器把develop/下的每个工具映射到对应入口。它不依赖系统 PATH，直接在源码树里运行 calibre：

./run-local ebook-convert input.rtf output.epub # 命令行转换 ./run-local calibre # 启动图形界面

桌面用户也可以直接安装官方预编译包，这里走源码是为了贴近代码、方便排错。安装细节见 INSTALL.rst，转换原理见 manual/conversion.rst。

🎯 标准转换三步走

在转换对话框中完成一次转换

1. 启动./run-local calibre，新建或打开一个书库，点"添加书籍"导入源文件。
2. 选中书籍，点工具栏的转换按钮，弹出转换对话框。左上角选输入格式（自动识别，一般不用动），右上角选输出格式。
3. 右侧编辑标题、作者、标签、封面等元数据；左侧标签页按需调整外观。
4. 点确定，转换完成后书库中会出现同书的新格式条目，设备直接从库同步即可。

转换对话框：左侧选流水线阶段，右侧改元数据

📚 转换之外：管理你的书库

按作者、标签、系列组织书籍

转换完的书自动入库。列表视图按标题、作者、大小、评分、系列排列，顶部搜索框支持author:"莎士比亚"、tags:经典这类查询语法，几千本书也能秒级定位。

列表视图：作者、标签、系列一列一列看得清

🎨 进阶定制：让输出符合你的口味

结构检测：自动生成目录

源文件没有目录时，进 Structure Detection 标签调整"章节标题"匹配规则（如匹配第一章这类模式），勾选"自动提取目录"。转换后 EPUB 会带完整目录，Kindle 上直接跳章节。

Look and Feel：字号与排版

进 Look & Feel 标签：字号比例设置控制整体缩放，行高、段间距直接调阅读舒适度。设一次，之后所有书统一套用，不必逐本微调。

Edit book：直接改 HTML

格式怎么调都不理想时，用 Edit book 打开编辑界面，直接改 XHTML 源码，右侧实时预览。

Edit book 界面：中间改源码，右边看效果

官方手册的建议流程是：先转成 EPUB，用编辑界面修到满意，再转其他格式。

⚠️ 避坑与常见问题

转换后目录错乱、章节丢失

原因：结构识别没抓到章节标题。解法：进 Structure Detection 手动指定章节匹配模式，或改用"按分页符切分"，再转一次。

命令行报错找不到输出格式

原因：格式名大小写不匹配。解法：输出格式名必须完整（EPUB、MOBI、AZW3），拼错就报 no such output plugin。

批量转换怎么做

命令行天然是批量的，套一层 shell 循环即可：

for f in books/*.rtf; do ./run-local ebook-convert "$f" "${f%.rtf}.epub"; done

🚀 收尾

一次转换 = 选源格式 → 调外观 → 选目标格式，剩下的交给流水线。calibre 把转换、编辑、库管理收进同一套工具链，格式兼容问题装完就能解决。现在克隆仓库，把手上那本格式不对的书转一遍试试。

【免费下载链接】calibreThe official source code repository for the calibre ebook manager项目地址: https://gitcode.com/GitHub_Trending/ca/calibre