--- url: https://eoht.net/notes/vcards.md description: >- 在 iPhone 和 Mac 使用 vCards 企业黄页，介绍 CardDAV 描述文件、手动订阅与 vCard 静态导入的区别，以及联系人检查、更新和移除方法。 --- # vCards 企业黄页：在 iPhone 和 Mac 订阅 CardDAV 联系人 {#improve-ios-android-caller-interface} [vCards](https://github.com/metowolf/vCards) 整理企业、服务机构的号码与头像，让已收录号码在通讯录、来电和信息中更容易辨认。显示效果取决于号码匹配和系统支持；它不负责验证来电者身份。 本文展开 iPhone、Mac 和 iCloud 的操作。描述文件只适用于支持它的 Apple 设备；Android 不使用这份描述文件，本页不承诺 Android 各厂商通讯录的兼容性。 | 方式 | 更新方式 | 联系人存放位置 | | --- | --- | --- | | CardDAV 描述文件或手动订阅 | 系统按账户的获取计划同步 | 独立的 CardDAV 账户 | | 下载 `.vcf` 后导入 | 一次性复制，后续需自行更新 | 你选择的本机或 iCloud 通讯录 | 三种方法选一种即可，重复订阅或导入可能出现重复联系人。操作前先备份现有通讯录。 ![CardDAV =688x](https://user-images.githubusercontent.com/2666735/59692672-0b6bdf00-9218-11e9-881e-5856e263f3aa.png "优化 iOS/Android 来电、信息界面体验") ## 方法一：在 iPhone 安装 CardDAV 描述文件 {#install-carddav-profile} ### 1. 使用系统相机扫描下方二维码，下载配置描述文件 {#download-carddav-profile} 也可以在 iPhone 浏览器中打开 [vCards 官方描述文件](https://vcards.metowolf.com/vcards.mobileconfig)。下载入口来自项目 README；安装前检查描述文件中的账户和服务器是否对应 vCards。 ![扫描二维码 =150x](https://github.com/user-attachments/assets/238f9d9a-5aa6-4636-8e67-4829535eaab9) ### 2. 打开“设置”App，轻点“已下载描述文件”或“注册 \[组织的名称]” {#open-downloaded-profile} ![打开描述文件 =320x](https://github.com/user-attachments/assets/12997c2d-6172-49f0-9236-0b4f30ad9ebd) ### 3. 在右上角点击“安装”，按屏幕提示操作完成导入。 {#complete-profile-installation} 下载文件本身不会完成安装。若“已下载描述文件”入口已消失，可重新下载后按 [Apple 的安装说明](https://support.apple.com/zh-cn/102400) 操作。 ## 方法二：手动订阅 CardDAV 服务 {#subscribe-to-carddav-manually} 手动添加与描述文件连接的是同一项 CardDAV 服务。黄页保留为独立账户，便于显示、隐藏和移除。 * 服务器：`vcards.metowolf.com` * 用户名：`cn` * 密码：`cn` 以上是项目提供的公共服务参数，不是你的 Apple 账户密码。 如担心隐私问题，可参考 [自建教程](https://github.com/metowolf/vCards/issues/208)。 ### 设置步骤 {#carddav-setup} * **iPhone** \[^1] 「设置」→「App」→「通讯录」（部分版本显示“联系人”）→「通讯录账户」→「添加账户」→「添加其他账户」→「添加 CardDAV 账户」。旧版 iOS 的“通讯录”直接位于设置首页。 * **Mac** \[^2] 「通讯录」→「设置」→「账户」→「其他通讯录账户」 保存账户后打开通讯录同步。iPhone 的“获取新数据”若选择“自动”，会在充电并连接无线局域网时下载新数据；这是抓取更新，并非实时推送。首次未显示时先检查账户是否启用、网络及获取计划，不要连续重复添加账户。\[^1] ## 方法三：下载导入 {#download-and-import-vcards} 1. 前往 下载最新打包文件 `archive.zip` 2. 解压后按需要选择 `.vcf` 文件，先用一个文件试导入并检查号码、名称和头像，再导入其余文件。 3. 确认目标账户，在支持列表的通讯录中将这些联系人加入“黄页”列表，方便辨认。导入的是当时的数据快照，不会跟随 vCards 项目自动更新。 ### macOS {#import-vcards-on-macos} * [在 Mac 上的“通讯录”中导入来自其他应用的联系人](https://support.apple.com/zh-cn/guide/contacts/adrbk1457/mac) 在“通讯录”中选择目标账户，再使用“文件”→“导入”选择 `.vcf`。出现重复联系人提示时先检查内容，不要直接批量合并个人联系人。 ### iOS / Web {#import-vcards-on-ios-or-web} 在平板电脑或电脑浏览器打开 [iCloud 通讯录](https://www.icloud.com/contacts/)，使用“添加”菜单中的“导入联系人”选择 vCard 文件，再在 iPhone 开启同一 Apple 账户的 iCloud 通讯录。具体入口见 [Apple 的导入说明](https://support.apple.com/zh-cn/guide/icloud/mmfba748b2/icloud)。 ## 检查结果与移除 {#verify-and-remove-vcards} 先在通讯录中选择 vCards 账户或导入的黄页列表，搜索一个文件中确实收录的名称，检查号码和头像。联系人可见只说明导入或同步成功，不代表所有来电、短信都能匹配。 * **手动 CardDAV 账户**：在通讯录账户设置中关闭该账户，或选择“删除账户”；Mac 在“通讯录”→“设置”→“账户”中停用或移除。 * **描述文件安装的账户**：在 iPhone「设置」→「通用」→「VPN 与设备管理」中找到对应 vCards 描述文件，再移除它。 * **静态导入的联系人**：先确认备份和具体联系人，再删除这批导入记录。仅移除列表不等于删除联系人；删除 iCloud 联系人会同步影响同一账户的其他设备。 \[^1]: [在 iPhone 的“联系人”中添加或移除账户](https://support.apple.com/zh-cn/guide/iphone/iph7edacccf9/ios) \[^2]: [在 Mac 上将来自 iCloud、谷歌等的联系人添加到“通讯录”](https://support.apple.com/zh-cn/guide/contacts/adrb7e5aaa2a/mac)