Obsidian 的笔记库（Vault）本质是一堆 .md 文件 + 附件文件夹。所谓“多端同步”，就是让这些文件在不同设备上保持一致。
本教程给你 4 种方案：官方 Obsidian Sync / iCloud / OneDrive / Syncthing。你可以根据设备组合与预算选择其一。
1）先做一次“库体检”（避免同步后问题放大）：
（1）在桌面端打开 Obsidian → 进入你常用的 Vault。
（2）设置 → 文件与链接：确认附件路径（附件建议集中到一个文件夹，如 attachments/）。
（3）设置 → 插件：记录你启用的核心插件清单；不建议一上来同步 30+ 插件。
2）给 Vault 起一个唯一名字
比如 MyVault_Notes。多端时不要出现两个同名 Vault 指向不同路径，容易混乱。
3）关闭“同时编辑同一篇笔记”的习惯
同步不是实时协作。强烈建议：同一时间只在一台设备编辑某篇笔记；否则冲突概率直线上升。
适合：你要跨平台（Windows/Mac/iOS/Android 都有），并且希望冲突少、体验稳定。
步骤：
（1）设置 → 账户（Account）登录 Obsidian 账号。
（2）设置 → Sync：新建一个 Remote Vault（远程库）。
（3）在当前设备勾选要同步的 Vault → 选择同步内容：建议先只同步 笔记与附件，插件/主题后面再开。
（4）在另一台设备登录同账号 → Sync → 选择同一个 Remote Vault → 下载到本地。
注意事项：
（1）第一次同步建议在 Wi‑Fi 环境完成，尤其是附件较多时。
（2）如果你要同步设置/主题/插件，建议“分批打开”，每次只开一类，出问题更好定位。
适合：Mac + iPhone/iPad 为主；Windows 只是偶尔查看（不太建议用 iCloud 来覆盖 Windows）。
步骤：
（1）在 Mac 上：Finder → iCloud Drive → 新建文件夹 Obsidian → 把 Vault 放到这里（或新建 Vault 直接选 iCloud 路径）。
（2）在 iPhone/iPad：安装 Obsidian → 打开 Vault → 选择“从 iCloud Drive 导入/打开”。
（3）确认 iOS 设置里 iCloud Drive 已开启，并给 Obsidian 允许访问文件。
常见坑与规避：
（1）iOS 上偶发“文件未下载完就打开”导致空白：等待 iCloud 同步完成再打开。
（2）不要在 iCloud 同步过程中同时大量重命名/移动文件夹。
适合：Windows + Android 为主，或你公司电脑强绑定 OneDrive。
关键点：移动端直接访问 OneDrive 文件夹并不总是顺畅，建议用“本地可用”的同步方式，而不是只在网盘 App 里浏览。
步骤（Windows）：
（1）确认 OneDrive 客户端已登录并在本机创建了同步目录（如 C:Users你OneDrive）。
（2）把 Vault 文件夹放进 OneDrive 同步目录。
（3）在 Obsidian 桌面端：打开现有 Vault → 指向 OneDrive 里的 Vault 路径。
移动端建议：
（1）如果你使用 Android，优先考虑方案 D（Syncthing）或官方 Sync；OneDrive 在移动端“本地文件夹映射”不如桌面端稳定。
（2）如果必须 OneDrive：确保文件“离线可用”，并避免在移动端频繁批量操作附件。
适合：你愿意折腾一点点，想要免费同步，并且不依赖云服务（设备之间点对点）。
步骤概览：
（1）在 Windows/Mac 安装 Syncthing（或 Syncthing 相关客户端）。
（2）在 Android 安装 Syncthing-Fork 等客户端（选择你熟悉的版本即可）。
（3）添加设备：互扫设备 ID/二维码，建立互信。
（4）共享文件夹：把 Vault 作为共享文件夹 → 选择另一台设备接收 → 指定本地路径。
（5）在每台设备的 Obsidian 里打开对应路径的 Vault。
注意事项：
（1）同一时间只在一台设备编辑同一篇笔记；Syncthing 的冲突文件会以“conflict”形式出现。
（2）首次同步建议只同步笔记与少量附件，确认稳定后再扩容。
问题 1：出现冲突文件（conflict）怎么办？
（1）先停下：不要继续在多台设备改同一篇。
（2）对比两个版本：通常一个是最新编辑，一个是旧版本。
（3）手动合并：把要保留的段落复制到一个文件里，另一个备份后删除。
（4）最后在所有设备都同步完成后再继续编辑。
问题 2：移动端打开 Vault 为空/缺文件
（1）确认同步工具完成：iCloud/OneDrive/Syncthing 是否显示“已同步”。
（2）检查权限：iOS 是否允许 Obsidian 访问文件；Android 是否给了文件访问权限。
（3）确认路径：移动端打开的是不是同一个 Vault 文件夹，而不是同名的另一个目录。
问题 3：插件/主题不同步，样式不一致
（1）这是正常现象：插件与主题属于“配置”，不同方案对配置同步支持不同。
（2）建议：先把核心笔记同步稳定，再逐步同步设置（或在每台设备手动安装必需插件）。
问题 4：图片/附件丢失或链接失效
（1）检查附件路径设置是否一致（建议统一为 attachments/）。
（2）避免在同步进行中批量移动附件文件夹。
（3）如果你从其他笔记软件迁移，先统一图片存放位置再开始同步。
追求稳定省心：选官方 Obsidian Sync。
苹果全家桶：选 iCloud（尽量不覆盖 Windows）。
Windows 主力、公司环境：OneDrive 可以用，但移动端建议配合官方 Sync 或换 Syncthing。
预算优先、想可控：Syncthing 很香，但要接受“需要你理解同步状态”的学习成本。
