Obsidian多设备云同步设置教程

本文详细介绍了如何利用 iCloud 实现 Obsidian 在 macOS 和 iOS 设备间的免费、稳定、低冲突多设备同步：通过在 Mac 上将库直接设为 iCloud 专属子文件夹、在 iPhone 上借助快捷指令精准注入相同路径、禁用自动合并并启用跨设备编辑锁定、配置 .icloudignore 过滤冗余文件，最终完成同步验证与冲突识别——整套方案不依赖付费插件或第三方服务，兼顾安全性与可控性，特别适合追求数据自主、拒绝云厂商锁定的深度笔记用户。

如果您希望在 Obsidian 中实现多设备间免费同步，同时避免移动端库路径配置错误导致的数据冲突，则需借助 iCloud 的文件同步机制进行手动路径绑定与结构隔离。以下是具体操作步骤：

一、在 macOS 上配置 Obsidian 库指向 iCloud 同步文件夹

该方法通过将 Obsidian 库根目录直接设为 iCloud Drive 中的专用子文件夹，使所有 .md 文件及 Vault 元数据由系统级同步服务托管，规避第三方插件依赖。需确保 macOS 系统已启用 iCloud Drive 并勾选“桌面与文稿文件夹”选项以保障路径稳定性。

1、打开 Finder，在边栏点击“iCloud 云盘”，右键新建文件夹，命名为 Obsidian-Vaults。

2、进入该文件夹，再次右键新建子文件夹，命名为 Main-Vault（或其他唯一标识名称）。

3、打开 Obsidian 桌面端，点击左下角“打开另一个库” → “打开文件夹”，导航至 iCloud 云盘 > Obsidian-Vaults > Main-Vault，点击“打开”。

4、首次打开时 Obsidian 会提示初始化库，确认后检查该文件夹内是否生成了 .obsidian 配置子目录及 index.md 默认文件。

二、iOS 端手动绑定同一 iCloud 库路径

iOS 版 Obsidian 不支持直接选择 iCloud 文件夹作为库，必须通过 Files App 的“添加快捷指令”方式将 iCloud 路径注入 Obsidian 的库列表。此操作绕过应用沙盒限制，使 iOS 端读取与 macOS 完全一致的文件节点。

1、在 iPhone 上打开“快捷指令”App，点击右上角“+”新建快捷指令，选择“添加操作” → 搜索并添加“浏览文件”动作。

2、点击“浏览文件”动作中的“位置”，选择“iCloud 云盘” → 进入 Obsidian-Vaults > Main-Vault，点击右上角“完成”。

3、再次点击“添加操作”，搜索“在 Obsidian 中打开”，添加该动作；点击其下方“文件”字段，选择上一步中已定位的 Main-Vault 文件夹。

4、运行该快捷指令，Obsidian 将弹出提示“是否添加此库？”，点击“添加”。添加成功后，该库将出现在 Obsidian 主界面“库切换器”中，名称显示为 Main-Vault (iCloud)。

三、启用 Obsidian 内置防冲突机制：禁用自动合并与启用只读锁定

当同一文件被 macOS 与 iOS 同时编辑时，iCloud 可能生成 .conflict 副本。Obsidian 需关闭默认的“自动合并更改”行为，并对正在编辑的文件施加跨设备可见的锁定标记，防止覆盖写入。

1、在桌面端 Obsidian 中打开设置 → “文件与链接” → 关闭开关项：自动合并来自其他设备的更改。

2、进入设置 → “核心插件”，启用 文件管理器 插件（如未启用），然后重启 Obsidian。

3、在任意笔记中输入命令面板（Cmd/Ctrl+P），执行 文件管理器：启用编辑锁定，确认启用。

4、检查 .obsidian/workspace.json 文件中是否存在 "lockFile": true 字段，若无则手动添加至顶层 JSON 对象内。

四、配置 iCloud 忽略非必要文件以减少同步延迟与冲突风险

iCloud 同步全部文件会导致临时缓存、插件日志等冗余内容参与同步，增加冲突概率与等待时间。应通过创建 .icloudignore 文件显式排除特定路径与扩展名，仅保留用户可编辑的核心内容。

1、在 macOS 的终端中执行：cd ~/Library/Mobile\ Documents/com\~apple\~CloudDocs/Obsidian-Vaults/Main-Vault。

2、运行命令：touch .icloudignore 创建忽略文件。

3、用文本编辑器打开该文件，逐行写入以下内容（每行一个规则）：
.obsidian/plugins/
.obsidian/themes/
.DS_Store
*.log
cache/

4、保存后退出编辑器，在 Finder 中确认该文件图标右下角显示 iCloud 云朵标志，表明已被纳入同步范围且规则已加载。

五、验证多设备同步状态与冲突文件识别流程

同步有效性需通过主动触发修改与跨设备响应延迟双重验证。关键在于识别 iCloud 是否已将变更推送至目标设备，以及 Obsidian 是否正确解析冲突副本而非静默覆盖。

1、在 macOS 端打开 index.md，添加一行文字：“macOS edit at [当前时间]”，保存。

2、等待 90 秒后，在 iOS 端 Obsidian 中刷新库，点击“索引”笔记，检查是否出现新增行；若未出现，下拉强制刷新或重启 Obsidian App。

3、在 iOS 端同一笔记末尾添加：“iOS edit at [当前时间]”，保存后立即切回 macOS，观察 Finder 中该文件的“修改日期”是否更新；若未更新，说明 iCloud 同步卡顿，需检查网络或 iCloud 设置。

4、强制断开一台设备网络，另一台设备编辑同一文件并保存，恢复网络后检查两设备对应文件夹中是否生成名为 index.md.conflict-YYYY-MM-DD-HH-MM-SS 的副本文件；该文件存在即表示防冲突机制生效。

以上就是《Obsidian多设备云同步设置教程》的详细内容，更多关于的资料请关注golang学习网公众号！