← 返回首页

安装 Mailbox Client

两种方式可选:从 Mac App Store 安装,或使用 Xcode 从源代码构建。随后通过 Google Takeout 导出 Gmail 邮件并导入归档。

第 1 步

从 Gmail 导出邮件

Google Takeout 可将 Gmail 中的全部内容导出为标准 MBOX 归档。这是离开或备份邮箱的官方、无附加条件的方式。

1

打开 Google Takeout

登录你的 Google 账户并访问 takeout.google.com。

2

仅选择邮件

点击取消选择所有,滚动至邮件并启用它。在邮件选项中保持格式为 MBOX。

3

选择所有标签(或一部分)

默认情况下 Takeout 会导出所有标签。如果希望归档更小,可只选择特定标签。

4

选择交付方式并下载

选择“通过电子邮件发送下载链接”,并将分卷大小设为 2 GB(Takeout 会生成一个或多个 .zip 文件)。等待 Google 的邮件并下载归档。每个 .zip 中都包含一个 .mbox 文件。

提示。十年的归档很容易达到 5–20 GB。导入前请确保磁盘空间充足。
第 2 步

获取 Mailbox Client

支持两种安装方式。请根据你的实际情况选择。

方式 A —— Mac App Store(推荐)

Mailbox Client 将通过 Mac App Store 发行。上架后,你可以像任何应用一样安装,并自动获取更新。

方式 B —— 从源代码构建

如果你希望跟进开发或参与贡献,可从公开仓库构建:

  • 安装 Xcode 16 或更新版本。
  • 克隆仓库:git clone https://github.com/lcajigasm/gmail-importer.git
  • 在 Xcode 中打开 Gmail importer.xcodeproj。
  • 选择 Gmail importer scheme。
  • 使用 ⌘ + R 构建并运行。
注意。由于历史原因,Xcode 项目名称仍为 “Gmail importer”——面向用户的产品名为 Mailbox Client。
第 3 步

导入归档

打开应用并导入 MBOX 文件。

1

点击“导入 MBOX…”

该按钮位于主窗口顶部的工具栏中。

2

选择一个或多个文件

系统文件选择器允许一次选择多个 .mbox 文件。每一个都会成为独立的资料库。

3

等待进度界面

你会看到五个步骤:准备、复制、解析、保存、重建索引。耗时取决于归档大小(在 Apple 芯片上,5 GB 的 MBOX 通常需要几分钟)。

4

开始浏览

使用侧边栏的资料库与标签进行过滤,在搜索框中输入即时查找邮件,点击任意邮件即可阅读。

第 4 步(可选)

调整设置

Mailbox Client 提供合理的默认值,但有四项开关值得一看。

通用

主题(浅色 / 深色 / 跟随系统)、覆盖界面语言。

智能

启用设备端摘要、分类与回复草稿。

Spotlight

将邮件索引到 Core Spotlight、重建索引或清除索引。

iCloud

启用 Mac 之间的私有 CloudKit 同步并查看状态。

故障排除

遇到问题时

以下是安装与导入过程中常见问题的简短列表。

  • “此 MBOX 文件看起来是空的。”请确保已解压 Google Takeout 归档。真正的 .mbox 文件位于 .zip 内部。
  • 导入耗时过长。导入数 GB 数据非常消耗 CPU。请接通电源,并让应用保持在前台运行。
  • “Apple Intelligence 面板未显示。”你需要 Apple 芯片的 Mac、运行 macOS 15.4 或更新版本,在系统设置中启用 Apple Intelligence,并位于支持的地区。
  • “部分邮件出现乱码字符。”在 Xcode scheme 中设置环境变量 MBOX_CHARSET_DEBUG=1 并重新导入,查看使用的字符集。通过支持页面反馈问题。