邮件
邮件导出是怎么工作的,从连接到排查问题。
连接
在 Exporter 主页上点邮件旁边的「连接」(连接之前,它在「还有 N 个应用」里),然后点「打开邮件文件夹」。面板会在 ~/Library/Mail 打开:选择这个文件夹本身。然后选择文件存放位置,点「使用这个文件夹」。
Exporter 通过你授权的文件夹,读取邮件保存在你 Mac 上的邮件。它不索取邮件权限,不要账户,也不要完全磁盘访问权限。
选择邮件
选择页面有两个标签,两边都勾选的邮件才会同步。
- 类型:邮件自己的标签。主要、交易、更新、推广,其余的归入「邮件未分类」。更新和推广默认不勾选
- 账户:每个账户以地址列出,里面是它的邮箱。草稿和废纸篓默认不勾选
已删除的邮件和垃圾邮件(Spam 与 Junk)无论勾选了什么都不会同步。列表上方的数字,是两个标签共同留下的邮件数。
文件去哪里
每封邮件一个 Markdown 文件,以日期、主题和一个编号命名:2026-09-28 Your order has shipped 491560.md。直接位于个人文件夹下的目录,比如 ~/Documents,里面会建一个 mail-export 文件夹;更深的目录会原样使用。
卡片上「选项…」里的「整理」决定文件夹结构:
- 按日期:
2026/09/,每年每月一个文件夹 - 按账户:每个账户一个文件夹,下面再按年
- 按类型:
primary/、transactions/、updates/、promotions/、unsorted/,下面再按年
更改「整理」后,下次同步时每个文件都会移动,旧位置不留任何东西。
文件内容
前置信息包含 from、to、mailbox、read、有旗标时的 flagged、account 和 kind,source_url 会在邮件中打开这封邮件。接着主题成为标题,正文转成 Markdown:标题、列表、表格和链接。附件留在邮件里。如果邮件从未下载某封邮件的正文,它的文件里会写明这一点。
免费与解锁
最新的 1,000 封邮件会导出并持续免费同步。解锁邮件是一次性购买:解锁后点「立即同步」,其余勾选的邮件就会同步。大邮箱的首次同步如果中途退出,会从停下的地方继续。
同步
Exporter 运行时会盯着邮件的索引,新邮件会自己变成文件。「立即同步」手动运行一次;「完全重新同步」把每个文件重写一遍。
命令行
exporter sync --source mail 像卡片上的「立即同步」一样同步邮件。exporter export --source mail --dest <folder> 把邮件写进在「命令行」卡片上授权的文件夹,不影响卡片自己的同步。参见命令行。
问题与排查
- 选择页面上没有邮件:在面板里选择
~/Library/Mail本身,而不是它里面的文件夹。先「断开连接」再「连接」,面板就会再次出现 - 少了一个账户:没有邮件可写的账户(比如一个空的发件箱)不会列出
- 文件里写着正文未下载:邮件只有邮件头。在邮件里打开这封邮件一次,下次同步就会写入正文