Obsidian 2026 最新最详细 iCloud 同步教程，手把手教学 100% 成功率

用前必读

按照 Obsidian 官方说明，使用 iCloud 同步时，笔记库应该放在这个位置：

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

这个「Obsidian」文件夹需要由 Obsidian App 自己创建，图标上会带有 Obsidian 的 Logo。手动新建的同名文件夹不会有 Logo，手机端 Obsidian 也可能无法识别。

因此我建议先在 iPhone 上创建一次 iCloud 笔记库，让 App 生成正确的「Obsidian」文件夹。之后无论是直接使用，还是迁移 Mac 上原来的笔记库，都围绕这个位置去处理。

完整设置流程如下。

在 iPhone 上创建 iCloud 同步文件夹

先在 iPhone 上安装并打开 Obsidian，然后创建一个新的笔记库。

大致步骤如下：

1. 点击「创建仓库」
2. 选择「设置同步」
3. 点选 iCloud，并启用 iCloud 存储
4. 输入一个笔记库名称
5. 点击「创建仓库」

完成这些步骤后，Obsidian 会进入笔记页面。

iCloud 云盘里需要出现一个手机端 Obsidian 能识别的专属文件夹。

打开 iPhone 的「文件」App，进入 iCloud 云盘，应该能看到一个带有 Obsidian 图标的「Obsidian」文件夹。Obsidian App 会把它作为 iCloud 里的专属位置，手机端后续会从这里读取笔记库（Vault）。

在 Mac 上打开这个笔记库

回到 Mac，先确认已经登录同一个 Apple ID，并且 iCloud 已经开启了同步。

如果你是第一次安装并打开 Obsidian，那么就直接点击「打开本地仓库」按钮。如果你在 Mac 上已经有正在使用的 Obsidian 笔记库，那么就点击左下角的「管理仓库」按钮，然后再点击「打开本地仓库」。

然后找到 iCloud 云盘里的 Obsidian 文件夹，再选择刚才在 iPhone 上创建的那个笔记库。

如果弹出下方提示，就点击「允许」。

这样 Mac 和 iPhone 打开的就是同一个笔记库，后续内容会通过 iCloud 同步。

你可以先在 Mac 上新建一条测试笔记，再等 iPhone 端同步完成后检查它是否出现。如果能正常同步，说明 iCloud 路径已经打通。

不同情况怎么处理

如果你已经在 iPhone 或 iPad 上创建过 Obsidian iCloud 笔记库，就不需要重新创建。直接在 Mac 上选择「打开本地仓库」，找到 iCloud 云盘/Obsidian/你的笔记库名称，打开它即可。

如果你原来只在 Mac 上使用 Obsidian，先按前面的方式用 iPhone 创建一次同步文件夹，然后回到 Mac，把原来的笔记库复制到 iCloud Drive/Obsidian/ 里面，再用 Mac 端 Obsidian 打开复制进去的那个库。

正确位置应该类似这样：

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

迁移完成后要检查什么

不管你是全新创建，还是从已有库迁移，最后都建议做一次检查：

1. Mac 和 iPhone 打开的是不是同一个库。
2. Mac 上新建的笔记，iPhone 是否能看到。
3. iPhone 上修改的内容，Mac 是否能同步回来。
4. 图片、PDF、录音等附件是否能正常打开。
5. iCloud 是否还在下载文件，文件旁边有没有云朵图标。

常见问题

可以直接在 Mac 上创建 iCloud 笔记库吗？

可以，Obsidian 官方说明里也写了，Mac 端可以在创建新库时，把位置选到 iCloud 云盘/Obsidian。

但对普通用户来说，我仍然更推荐先用 iPhone 创建一次，因为很多同步问题都出在手机端识别不到正确文件夹。先让手机端生成正确位置，后续再从 Mac 打开或迁移，路径会更清楚。

可以手动创建 iCloud Drive 里的 Obsidian 文件夹吗？

不可以。官方说明里特别提醒，iPhone 和 iPad 上应该使用带有 Obsidian 图标的文件夹，不要使用普通文件夹。

普通文件夹即使也叫「Obsidian」，手机端也可能无法按预期识别。

可以把同一个库同时交给 iCloud 和 Obsidian Sync 吗？

不建议。同一个库最好只使用一种同步方式，多个同步工具同时处理同一批文件时，容易出现冲突、重复文件和配置错乱。

已有 Mac 笔记库，迁移到 iCloud 前一定要备份吗？

是的，iCloud 第一次同步整个笔记库时，可能会花比较长时间。

用「复制」代替「移动」，至少可以确保本地原始库还在。确认两端都能正常打开，笔记和附件也都完整后，再处理原来的本地副本。

iCloud 同步慢怎么办？

先确认 iCloud Drive 已经开启，并且两台设备登录的是同一个 Apple ID。

然后打开「文件」App 或 Finder，看文件是否还在上传或下载。附件很多、图片很大、第一次迁移整个库时，同步慢很正常。在同步完成前，不要急着在多台设备上大量修改同一批笔记。

如果你使用的是 macOS 15 或更新版本，可以在 Finder 里右键点击 iCloud Drive 里的 Obsidian 文件夹，选择「保持下载」。这样可以减少文件被 iCloud 自动卸载后，Obsidian 临时读取不到的情况。

如果你使用的是 macOS 14 或更早版本，可以检查 iCloud 设置里的「优化 Mac 储存空间」。这个设置会影响整个 iCloud，不只影响 Obsidian，所以调整前要先确认自己是否接受这个变化。

我迁移后手机上看不到库怎么办？

先去 iPhone 的「文件」App 里检查路径：

iCloud Drive/Obsidian/你的笔记库名称

确认它确实在带 Obsidian 图标的文件夹里面。如果它在 iCloud Drive 的其他位置，或者在一个普通的「Obsidian」文件夹里，手机端就可能无法正常读取。

小结

用 iCloud 同步 Obsidian，关键是把库放在 iPhone 和 iPad 能识别的正确位置。

我更建议先在 iPhone 上创建一次 iCloud 笔记库，让 iCloud 生成正确的 Obsidian 文件夹。之后再根据你的情况，继续用这个新库，或者把 Mac 上原来的库复制到这个位置。

只要路径正确、同步方式单一、迁移前有备份，iCloud 就可以承担苹果设备之间最基础的 Obsidian 同步需求。

相关同步教程

• Obsidian 百度网盘同步教程：电脑之间同步 Vault 的完整设置方法
• Obsidian Remotely Save 同步教程：腾讯云 COS 配置完整指南
• Obsidian 飞牛 NAS 同步教程：WebDAV + Remotely Save 配置指南