2026/05/07

用 iCloud 实现 Mac 与 iPhone 的 Obsidian 笔记同步

梳理通过 iPhone 建立带官方图标的 Obsidian iCloud 专属目录，并在 Mac 与手机之间打开同一个笔记库的完整配置流程，避开移动端识别不到路径的常见陷阱。

用 iCloud 实现 Mac 与 iPhone 的 Obsidian 笔记同步

专属同步目录机制

iCloud 是苹果生态自带的文件同步通道，不需要额外安装第三方插件，配置起来相对轻量。但在使用 iCloud 同步时，笔记库在云盘里的物理路径有明确要求。

iCloud 云盘/Obsidian/你的笔记库名称

这个路径里的「Obsidian」文件夹必须由移动端 App 首次初始化时生成，在系统「文件」App 中会带有官方的专属图标。如果在电脑上自行手动新建一个同名文件夹，外观只是普通目录，移动端的 Obsidian 往往无法正确识别它内部的笔记库。

初次配置最省心的做法，是先在 iPhone 上新建一次空白笔记库，让系统自动生成带专属图标的父级目录。之后不管是直接在手机上记录，还是把 Mac 本地已有的存量库搬迁进来，都统一放在这个专属位置。

在 iPhone 上建立专属文件夹

先在 iPhone 上安装并打开 Obsidian 客户端，创建一个全新的空白库来触发目录初始化。

点击「创建仓库」
点击「设置同步」
勾选使用 iCloud 存储
输入笔记库名称
点击确认创建

在设置界面中勾选使用 iCloud 存储，库名可以先填一个临时的测试名称，后续确认两端同步正常后再继续添加内容。

完成创建后，Obsidian 会直接进入初始笔记页面。

此时返回手机桌面，打开系统自带的「文件」App 并进入 iCloud 云盘，能看到一个带有紫色 Obsidian 标识的专属文件夹。这个文件夹是移动端沙盒读取笔记库的指定入口，后续所有需要在手机上打开的库都要收纳在这里。

在 Mac 端打开同一个库

回到 Mac 电脑，确认登录了同一个 Apple ID，并在系统设置中确认开启了 iCloud 云盘功能。

在 Mac 上打开 Obsidian。如果是初次安装，点击开始面板上的「打开本地仓库」；如果已有正在使用的笔记库，点击左下角的管理仓库图标，再选择打开本地文件夹。

在 Finder 弹出的浏览窗口中，找到 iCloud 云盘里的 Obsidian 文件夹，选中刚才在手机端创建的那个笔记库。

如果系统弹出文件夹访问权限提示，点击允许继续。

完成这几步后，Mac 与 iPhone 打开的就是同一套底层文件，日常改动会由 iCloud 在后台静默同步。可以在电脑端新建一篇测试笔记，稍作等待后在手机端观察是否自动显示。

存量库迁移方法

如果此前已经在 iPad 或其他苹果设备上建立过带图标的专属目录，不需要重复新建。直接在 Mac 端打开本地目录，定位到 iCloud 云盘/Obsidian/你的笔记库名称 打开即可。

如果原本只在 Mac 本地硬盘使用 Obsidian，建议先用手机创建一次触发专属目录生成，再在 Mac 的 Finder 里把旧笔记库复制到 iCloud 云盘/Obsidian/ 目录下，随后在 Mac 客户端重新打开复制过去的新位置。

放好之后，笔记库在云盘里的完整路径如下。

iCloud 云盘/Obsidian/你的笔记库/

核心连通检查

无论是全新起步还是从旧库迁移，接入后建议按以下清单确认一次。

Mac 与 iPhone 打开的是同一个库名称
电脑端新建的测试文档能在手机端顺利刷出
手机端追加的编辑内容能自动传回电脑端
图片与 PDF 等附件文件在移动端能正常预览
检查文件旁边是否存在未完成下载的云朵等待标记

常见疑问与排查

在 Mac 端直接建库的差异

在 Mac 上新建笔记库时，确实可以直接把存储位置选在 iCloud 云盘中。

但在苹果生态里，依然建议先由 iPhone 触发一次初始化。多数移动端找不到库的情况，都是因为 iOS 沙盒无法把普通文件夹当成应用专属容器。让手机端先生成带图标的专属目录，后续两端接入的路径最为清晰。

手动新建同名目录的失效原因

在电脑上手动新建一个同名文件夹，无法正常作为移动端的同步入口。带有专属图标的文件夹属于系统为特定应用开辟的沙盒容器，普通文件夹即便命名完全相同，由于缺少对应的沙盒标识，手机端在加载时依然无法将它识别为受支持的库。

与其他同步方案混用的风险

同一个笔记库内不要混用多种同步机制。如果同时开启 iCloud 与第三方文件同步服务，多个后台进程同时读写相同文件，容易导致时间戳混乱、生成冲突副本并覆盖配置文件。

迁移时使用复制代替移动

iCloud 在处理首次大规模数据上传时耗时较长。

在 Finder 中复制旧库，不要直接剪切。这样本地能始终留存一份完整的原始副本，等待云端完全同步、两端校验无误后，再决定如何处置旧的本地文件。

同步延迟与保留本地下载

遇到同步迟缓时，先确认两端登录了同一个 Apple ID，并在网络状态良好的环境下查看文件传输进度。如果笔记库内包含大量高分辨率图片或成百上千份历史文档，首轮传输需要足够的排队时间。

在 macOS 15 及更高版本中，可以在 Finder 里右键点击 iCloud 云盘中的 Obsidian 目录，选择「保留下载」，避免系统为了节省磁盘空间而自动卸载本地缓存。

在 macOS 14 及更早版本中，如果开启了系统的「优化 Mac 储存空间」，系统可能会临时清理未使用的本地文件，导致客户端打开时需要临时联网等待。

移动端识别不到笔记库的排查

打开 iPhone 的「文件」App，检查笔记库的具体层级。

iCloud 云盘/Obsidian/你的笔记库名称

确认文件夹确实位于带紫色 Logo 的专属父级目录内部。如果保存在云盘根目录或其他普通文件夹下，移入该专属目录后重新打开即可识别。

适用场景与总结

借助 iCloud 同步 Obsidian 的关键，在于让文件始终位于移动端能识别的专属容器内。

由 iPhone 完成首次初始化并生成专属文件夹后，后续日常使用或存量迁移都会省心很多。只要保持路径规范、避免多重同步冲突并在迁移前保留本地备份，iCloud 足以支撑苹果全家桶用户最日常的基础同步需求。

全部文章