# 通讯录

通讯录导出如何工作，从连接到修复问题。

## 连接

在通讯录卡片上点按“连接”。面板会在你的 AddressBook 文件夹 `~/Library/Application Support/AddressBook` 中打开：点按“选择此文件夹”。Exporter 只读取这一个文件夹，不会弹出权限请求，你的 iCloud 和 Exchange 名片也从这里读取。然后点按“选择导出文件夹”。

## 文件存放在哪里

每张名片一个 Markdown 文件，如 `Anna Kowalski.md`。两个同名的人各自会加上一个简短的 id 后缀，谁的文件都不会覆盖对方。直接位于个人文件夹中的文件夹，如 `~/Documents`，会在其中新建一个 `contacts-export` 文件夹；更深层的文件夹，如 `~/Documents/contacts`，会被直接使用。

卡片当前所在的标签页也决定了文件夹结构：

| 标签页 | 文件存放在 |
| --- | --- |
| 全部、最近 | 导出文件夹的顶层 |
| 群组 | `groups/<group>/`；同时属于两个群组的名片只写一次，放在第一个群组下 |
| 公司 | `companies/<company>/` |

切换标签页会在下次同步时移动文件，卡片会在标签页下方提示这一点。“最近”列出最近更改的 100 张名片；“群组”和“公司”的树形列表末尾分别是“未分组”和“无公司”。

## 导出的内容

卡片上勾选的名片，连同它们的所有字段。不会导出：Gmail 为你写过信的每个地址收集的、只有邮箱的条目。没有 vCard 或 CSV 导出：如需 `.vcf`，请在通讯录中使用“文件”>“导出”>“导出 vCard”。

## 格式

始终是 Markdown。

## 文件

每个键只在名片有对应值时出现。列表中的值带有自己的标签，如 `+1 415 555 0123 (mobile)`。

| 键 | 内容 |
| --- | --- |
| `title` | 姓名 |
| `aliases` | 昵称和婚前姓 |
| `id`、`source_url` | 名片的 id，以及一个在通讯录中打开它的 `addressbook://` 链接 |
| `created`、`modified` | 名片的创建时间和最后更改时间 |
| `organization`、`job_title`、`department` | 工作信息 |
| `birthday` | 生日 |
| `email`、`phone` | 第一个电子邮件和电话，不带标签，方便模板使用 |
| `emails`、`phones`、`addresses`、`urls` | 每一项，带有自己的标签 |
| `social`、`im` | 社交资料和即时通讯账户 |
| `dates`、`relationships` | 其他日期和关联人姓名，如 `father: Tom Kowalski` |
| `groups` | 名片所属的通讯录群组 |
| `conversations` | 同时导出了信息时，指向这张名片相关对话的链接 |

正文是姓名、职位行和名片的备注：

```markdown
---
title: "Anna Kowalski"
id: "410FE041:ABPerson"
created: 2019-04-02T10:15:33
modified: 2026-08-30T19:02:11
source_url: "addressbook://410FE041:ABPerson"
organization: "Northwind Studio"
job_title: "Art director"
birthday: 1990-12-10
email: "anna@northwind.example"
phone: "+1 415 555 0123"
phones:
  - "+1 415 555 0123 (mobile)"
groups:
  - "Studio"
---

# Anna Kowalski

Art director · Northwind Studio

Met at the print fair.
```

## 免费与解锁

在你勾选的名片中，前 100 张可以免费导出并持续免费同步，删除一张名片会让出它的名额；其余的需要一次性解锁（[价格](https://exporter.dev/pricing)）。

## 同步和完全重新同步

首次点按“立即同步”后，只要 Exporter 在运行，编辑过的名片就会重写它的文件，已删除名片的文件会在下次同步时移除。

“完全重新同步”会先询问，然后只删除 Exporter 写入的文件，重新写出每张名片，并重新选定免费的 100 张。导出文件夹中的其他内容都会保留。

## 问题和修复

- “该文件夹中没有通讯录数据库（请选择 AddressBook 文件夹本身）”：再次点按“连接”，然后选择面板打开时所在的文件夹
- 文件移到了其他文件夹：卡片切换到了另一个标签页。回到你想要的标签页，然后点按“立即同步”
- 缺少一张名片：它超出了免费的 100 张、未被勾选，或者是来自 Gmail 的只有邮箱的条目
- 某张名片导出失败：`上次同步` 会显示一个红色的“详情”链接，列出失败的名片，每张都有一个“打开”链接

## Related

- [Contacts](https://exporter.dev/contacts): Every contact card as a Markdown file
- [Contacts guides](https://exporter.dev/guides/contacts): People notes in Obsidian
- [Messages](https://exporter.dev/docs/messages): Conversations, media, fields and fixes

---

human version: https://exporter.dev/zh-hans/docs/contacts
every page: https://exporter.dev/llms.txt