本页目录
Obsidian用iCloud同步怎么办？
打开iCloud Drive后，在“iCloud Drive → Obsidian”文件夹中创建保管库。 iPhone的话，在新建保管库时打开“保存到iCloud”即可，如果是Mac的话，只需在文件选择器中选择iCloud Drive中的Obsidian文件夹即可。
2台从“作为保管库打开文件夹”开始指定相同的文件夹。 官方文件提醒放置位置，如果在iCloud Drive/Obsidian/[保管庫名]之外制作的话，可能会出现同步问题。
步骤1: 打开iCloud Drive
在同步的终端上登录同一个Apple Account，激活iCloud Drive。 设置画面的名称因OS版本而异，所以Apple的设置指南也请确认。
- iPhone / iPad
“设置”→自己的账户→在“iCloud”中打开Drive，打开“同步这个iPhone”或“同步这个iPad”。 - Mac
“系统设置”→自己的账户→“iCloud”→“Drive”打开“同步此Mac”。
步骤2：在iCloud里面建造保管库
用第一个1台制作。 从iPhone和Mac哪个制作都可以，但是制作方法不一样。 iPhone是切换1个，Mac是自己选择文件夹。
用iPhone / iPad制作时
- Obsidian，点击“新建保管库”。
- 输入保管库的名字。
- 打开“保存到iCloud”。 这里是本体。 在关闭状态下制作的话，那个保管库只留在终端里面。
- 点击“制作”。
用Mac制作时
- Obsidian，选择“新建保管库”。
- 文件选择器移动到iCloud Drive → Obsidian。
- 制作保管库用的文件夹，并命名。
- 选择“制作”就完成了。
iCloud Drive中，有应用程序为自己使用的领域。 带有Obsidian应用程序图标的“Obsidian”文件夹就是那个，iOS版的Obsidian读写就是这里面。 用相同名字自己制作的纯文件夹是另一回事，官方文件“请不要使用没有应用程序图标的纯文件夹”点名警告。
步骤3：2台打开同一个保管库
2台不新建。 去打开已有的文件夹。 如果在这里新建的话，就会排列一个同名的保管库2。
- 在2台的Mac或iPhone上打开Obsidian。
- 打开保管库切换器，选择“作为保管库打开文件夹”。
- iCloud Drive → Obsidian，选择1台制作的保管库文件夹。
官方程序确认的3项目
官方指南提醒注意的是保管库的位置、文件的退避、同步方式的混合。 确认以下项目，操作后用同一个笔记确认反映。
保管库在“Obsidian”文件夹外面
正确的位置是iCloud Drive/Obsidian/[保管庫名]。 iCloud Drive正下方和“文件”中建造的保管库，从iOS版的Obsidian看不到，会产生同步问题。 确认方法如下。
- 用iPhone打开“文件”App。
- 点击“浏览”，选择“地点”下方的iCloud Drive。
- 保管库在Obsidian文件夹中。 在更改位置之前，请备份到另一个位置，确认不要覆盖同名的保管库。 变更后用Obsidian打开，确认笔记本和其他终端的同步。
iCloud正在从终端撤离文件
iCloud有将未使用的文件实体从终端中驱逐出来，只留在云端的机制。 Obsidian可以直接访问保管库里的东西，如果没有实体的话，就会被当作找不到文件。 官方文档的FAQ明确指出，这种退避是同步问题的原因。 处理方式在macOS的版本中不同。
| 环境 | 要做的事情 | 影响范围 |
|---|---|---|
| macOS 15（红杉）以后 | iCloud Drive内的Obsidian文件夹右击，选择“维持下载” | 只有Obsidian的文件夹 |
| macOS 14（Sonoma）以前 | iCloud设置的关闭“优化Mac存储” | 终端上的所有iCloud存储 |
官方文档将此定位为“是任意的，但为了保持读取速度，强烈推荐”。 macOS 14之前的设置除了Obsidian以外也有效果，所以需要了解这一点后再关闭。
重复同步方式
官方文档在“避免混用同步服务”一节中说明，不要用多个服务同步同一个库，例如同时使用 Obsidian Sync 与 iCloud。这是为了防止数据冲突或损坏。如果免费的 iCloud 已能满足需求，但仍想试用官方 Sync，请先将同步方式统一为其中一种，再进行切换。
出于同样的原因，避免Windows的iCloud Drive。 官方文档明确指出，iCloud的推荐系统为macOS、iOS、iPadOS，Windows上的iCloud Drive可能会发生文件的重复和损坏。 如果同时使用Windows和Android的话，就会选择iCloud以外的方式。
iCloud携带的是“整个文件夹”
保管库是只是一个文件夹，里面除了写的Markdown文件外，还有包含设置的.obsidian文件夹。 iCloud Drive以文件夹为单位同步，所以不仅是笔记，设置也会一起携带。 对很多人来说，这是方便的默认（主题和热键都在2台上）。
如果想按终端划分设置的话，官方文档介绍按终端更改设置文件夹的功能（Syncthing的章节中也写着“如果想按终端划分设置，请将.obsidian从同步对象中移除”，前提是设置在保管库中）。 iCloud没有排除指定，如果想分开的话就使用这个功能。
官方资料和实机确认范围
2026年9月30日重读了Obsidian官方的英语・日语同步指南。 参考了关于保管库的位置、下载状态、同步方式的混合的指南。 翻译的更新时间可能因语言而异，如果操作不一致，也请确认英文版。 阅读资料和实施，以及在终端之间同步是另外的确认。 这次更新没有实际测量iCloud的同步时间和同时编辑时的行为。
iCloud上面的保管库，从外面写入
SimpleMemo可以直接在允许访问的保管库的笔记本上补充。 在iPhone上写入和通过iCloud在其他终端上反映是不同的阶段。 首先确认保存地址的写入，然后确认Mac等相同的笔记。
NSFileCoordinator来协调文件访问，并通过队列依次处理写入。这是应对写入冲突的措施，并不保证在包括其他设备同时编辑和 iCloud 同步在内的所有环节中，都不会遗漏写入。打开连接，设置保管库和补充地址，确认简短的测试文。 写入测试不发送邮件，之后确认iCloud同步到其他终端。
PC用户用智能手机读取
常见问题
保管库放在iCloud Drive的什么地方好呢？
iCloud Drive/Obsidian/[保管庫名] 这一位置，并明确要求使用带有 Obsidian 应用图标的文件夹，不要使用没有该图标的普通文件夹。请在“文件”App 中打开“浏览 → iCloud Drive”，确认库位于 Obsidian 文件夹内。在iPhone中笔记本是空的或者不是最新的
iCloud和官方Obsidian Sync都可以同时使用吗？
Windows的iCloud Drive也可以同步吗？
SimpleMemo可以写入iCloud上面的保管库吗？
更新确认：2026年9月30日。 核对了Obsidian官方的同步指南和Apple的iCloud Drive设置指南、SimpleMemo的保管库访问、写入、保留处理的来源。 没有进行实机测量。 同步时间、同时编辑时的结果、分发版中所有条件的动作，仅凭这个核对无法确认。 2026年8月27日记载的Linux资料比较也不是iCloud的实机验证。 设置变更后，请确认简短的测试文的保存和其他终端的反映。
相关页面
参考文献
- Obsidian Help — Sync your notes across devices（英语・原文来源） — 官方文档的源存储库。 2026年9月30日再次确认原文。 公开版是help.obsidian.md/sync-notes
- Obsidian 帮助 — 在设备之间同步笔记（日语版） — 同一存储库的日语版。 用于与英文版的对比
- obsidianmd/obsidian-help — “以英文版为正，所有页面在各语言中准备1对1”的翻译方针的出处
- Obsidian的同步方法比较（本网站） — 实测Git和Syncthing竞争时的破坏方式的报道。 与iCloud的比较定位在这里。 手动修复Git的正文冲突的例子，请参考留下原文比较的步骤。
- SimpleMemo — App Store — App Store的下载页面