如果你用 Obsidian 做长期笔记或项目资料库，最头疼的往往不是“怎么写”，而是：换设备后文件没同步、插件/主题不一致、附件路径乱、以及多端同时编辑引发的冲突。本文给你一套可执行的多端同步方案选择表 + 落地步骤，并把冲突处理、附件与插件一致性、备份与迁移这些关键点一次讲透。
在开始同步前，先把 Vault（库）结构整理成更不容易出问题的形态：
1）建议使用英文/数字文件夹名，减少跨平台编码差异；2）将附件统一放到一个目录（如 Attachments/），并在 Obsidian 的“文件与链接”里把附件默认位置设为该目录；3）尽量避免把 Vault 放在会被系统自动“按需下载/云端占位”的目录里（这类占位文件会让同步误判）。
工具地址/参考链接：https://obsidian.md/
方案 A：Obsidian Sync（官方） —— 最省心，跨端体验最好，支持版本历史与端到端加密。适合愿意付费、追求稳定的人。
方案 B：系统云盘（iCloud/OneDrive/Dropbox 等） —— 成本低、上手快，但冲突与占位文件需要重点规避。适合轻度笔记与单人使用。
方案 C：Syncthing（点对点同步） —— 不依赖中心云盘，局域网/互联网都可同步，控制力强；但需要你理解“谁是主库、何时同步、冲突怎么处理”。适合对数据与路径控制要求更高的人。
1）在桌面端登录账户并开启 Sync；2）选择要同步的 Vault；3）在移动端（iOS/Android）安装 Obsidian 后登录同一账户，选择“从 Sync 拉取”。
关键设置建议：
- 将“历史版本/回滚”保留周期设得略长一些（比如 30 天），这是你对抗误删与冲突的最后保险；
- 同步内容建议包含：笔记、附件、主题/片段（snippets）；插件建议“分批启用”，先保证纯文本与附件同步稳定，再逐步打开高风险插件（例如会批量改写文件的插件）。
云盘同步的核心风险是“占位文件”和“多端同时写入”。你可以用下面几条规则把问题概率降到最低：
1）确保 Vault 所在目录是“始终保留在本地”（不要按需下载）；2）不要在两台设备上同时编辑同一篇笔记；3）移动端尽量在网络稳定时打开/关闭 Obsidian，避免后台频繁重试导致冲突文件。
如果你在 Windows 上用 OneDrive：建议把 Vault 放在一个独立的同步文件夹里，并关闭该文件夹的“节省空间/按需”选项。macOS 上用 iCloud：不要把 Vault 放在会被系统自动清理的目录，并注意文件名大小写差异带来的重复文件问题。
Syncthing 的正确打开方式是：把其中一台设备当作“主编辑端”（通常是你的笔记主力电脑），其它设备以“尽量少改动、以阅读与轻量编辑为主”的方式使用。这样冲突会显著减少。
安装（示例）：
macOS 可用 Homebrew：
brew install syncthing
Windows 可使用官方安装包或包管理器（请以官方文档为准）：
配置要点：
1）把 Vault 目录加入同步；2）在高级设置里建议开启文件版本控制（Versioning），至少保留若干历史版本；3）忽略规则里可以排除明显的临时文件，但不建议粗暴排除 Obsidian 的 .obsidian/ 配置目录，否则多端体验会不一致。
无论你用哪种方案，冲突文件出现的原因几乎都一样：两端在短时间内都修改了同一个文件。处理流程建议固定化：
1）先停止另一端编辑，避免冲突扩大；2）找到两份文件的差异（可用对比工具），把需要的段落合并到一个最终版本；3）确认附件引用是否仍然正确；4）最后再恢复同步。
建议准备一个对比工具（任选其一）：
同步不是备份。建议至少再加一层备份：
- 定期把 Vault 打包到一个只读备份位置；
- 或使用 Git 做版本管理（即便不发布到公网，也可以本地仓库存档）。
如果你用 Git，注意：不要把含有敏感信息的库推到公共仓库；并确保二进制附件（图片/PDF）会显著增大仓库体积，可按需使用 LFS 或把附件单独备份。
完成同步后，用这份清单快速验收：
1）任意一篇笔记的内部链接可正常跳转；2）插入的图片/PDF 在所有设备都能打开；3）主题与常用插件在另一端也可用；4）离线状态下仍能打开最近使用的笔记；5）新建一条测试笔记并在另一端成功出现。
