同步前先做两件事：1）把库路径放到“普通文件夹”，不要放在临时目录；2）确认库内文件命名稳定（尽量少用特殊符号），并先做一次完整备份（复制整个库文件夹到另一处）。
建议：库内尽量只同步 Markdown 与附件（图片/PDF），不要把缓存目录/临时导出目录塞进库里；插件配置一般也能同步，但遇到问题可先关闭部分插件排查。
适用场景：你主要在苹果生态使用，追求“系统级、少折腾”。
步骤：
1）Mac：打开“系统设置 → Apple ID → iCloud → iCloud 云盘”，确保已开启。
2）Mac：在 Finder 里确认存在“iCloud Drive/Obsidian”文件夹（没有就新建）。
3）Mac：Obsidian → 打开库（Open folder as vault）→ 选择 iCloud Drive/Obsidian/你的库名。
4）iPhone/iPad：设置 → Apple ID → iCloud → iCloud 云盘开启；安装 Obsidian 后，在“打开库”里选择 iCloud Drive 里的同名库。
注意事项：首次同步可能需要较长时间；同步期间尽量不要同时在多台设备大规模重命名/移动文件，先等一台设备同步完成再继续操作。
适用场景：主力在 Windows，电脑之间同步稳定；手机端可配合第三方同步（或改用 WebDAV 方案）。
步骤：
1）Windows：安装并登录 OneDrive，确认“同步此电脑上的文件夹”正常。
2）把 Obsidian 库移动到 OneDrive 同步目录内，例如：OneDriveObsidian你的库名。
3）Obsidian 重新打开该库（Open folder as vault），确认可以正常读写。
4）第二台 Windows：等 OneDrive 完整下载该库后，再用 Obsidian 打开同一文件夹。
注意事项：务必等 OneDrive 状态显示“已同步/最新”，再切换到另一台设备编辑；避免两台电脑同时离线编辑同一文件，冲突概率会显著上升。
适用场景：你需要电脑+手机跨平台同步，又不想依赖某一家系统云盘；愿意按步骤配置一次。
推荐做法：用“同步工具”把库当作文件夹同步，而不是把库直接放在某个不稳定的网络盘挂载点。
配置思路（通用步骤）：
1）在坚果云创建一个专用目录（例如：/Obsidian/你的库名）。
2）电脑端：用坚果云客户端把本地库与该目录同步（优先用官方客户端的文件夹同步功能）。
3）手机端：如果你使用支持 WebDAV 的同步/文件管理工具（例如部分 WebDAV 客户端），让它把同一目录同步到本地一个固定文件夹。
4）手机 Obsidian：打开同步到本地的库文件夹作为 vault。
关键点：确保“本地实际文件夹”存在且可离线访问；不要让 Obsidian 直接编辑一个只读或不完整下载的目录。
1）看到冲突文件（常见是文件名带 conflict 或出现重复副本）：先暂停编辑，复制冲突文件两份到“_conflicts”文件夹保留证据，再对照时间戳合并内容。
2）大规模重命名/移动：分批做（每次 20-50 个文件），每批结束等待所有设备同步完成。
3）附件（图片/PDF）体积大：先在一台设备完成导入与整理，再让其他设备同步，避免同时导入造成重复。
Q1：手机打开库提示找不到文件/内容不全？ 说明该目录还没完全同步到本地。先在同步工具里手动触发“下载全部/离线可用”，等完成后再打开。
Q2：iCloud 同步很慢或卡住？ 先检查 iCloud 云盘开关与存储空间；把库里大文件（视频/超大 PDF）暂时移出库；必要时在 Mac 上让 iCloud 完整同步后再在手机端打开。
Q3：OneDrive 反复显示“正在处理更改”？ 先暂停/恢复同步；检查是否有超长路径或特殊字符文件名；把库路径尽量放浅一点（例如 OneDriveObsidianVault）。
Q4：插件导致闪退/索引异常？ 先在一台设备禁用最近新增插件；确认库能正常打开后再逐个启用。
1）同一时间只在一台设备做“结构性操作”（移动/批量重命名/导入大量附件）。
2）每周做一次离线备份：直接复制整个库文件夹到备份盘或另一个目录。
3）把库内“自动生成内容”单独放子文件夹：例如 Excalidraw、导出文件等，便于排查与清理。
