Mac版Obsidian插件库（.obsidian）必须与Vault主文件夹整体云同步，否则多端主题错乱、插件失效；推荐Nutstore Sync插件并勾选“同步配置目录”及“覆盖远端配置”，或用Remotely Save指定Vault根路径，或Syncthing点对点同步完整Vault目录。
Mac版Obsidian插件库（即.obsidian文件夹）需要在多端保持一致，否则手机或Windows端打开时主题错乱、快捷键失效、插件不加载——这不是单纯同步笔记的问题，而是整个编辑环境的复刻需求。
前提：必须先统一同步根目录
插件库不能单独同步。它必须和你的Vault主文件夹一起被云服务托管，否则路径断裂会导致插件报错、主题白屏、甚至Obsidian启动失败。
确认你的Obsidian仓库（Vault）已整体纳入云同步体系：坚果云客户端已将该文件夹设为“同步文件夹”，或OneDrive客户端已将其移入OneDrive/Obsidian-Vault路径下，或Syncthing已将其设为共享文件夹。这一步没做完，后面所有操作都无效。
方案一：用Nutstore Sync官方插件同步（推荐，含配置目录）
方法一：启用.obsidian同步开关
打开Obsidian → 设置 → 第三方插件 → Nutstore Sync → 设置页 → 勾选【同步 Obsidian 配置目录（.obsidian）】→ 保存设置。
这一步必须手动开启，默认关闭。不勾选=只同步笔记，不碰插件、主题、快捷键、工作区布局等任何配置项。
方法二：首次同步前强制全量覆盖
点击“检查连接”确认成功后 → 点击“同步”按钮 → 在弹窗中选择【严格模式】→ 勾选【覆盖远端配置】→ 确认执行。
【覆盖远端配置】是关键动作，否则手机端可能残留旧主题CSS或损坏的插件缓存，导致界面异常。
同步完成后，在iPhone Obsidian中重启App，观察左上角是否立即显示你Mac端设置的深色主题+自定义侧边栏图标——若出现，说明.obsidian已完整落地。
方案二：用Remotely Save同步（需手动指定路径）
第一步：确保.obsidian与笔记在同一级目录
你的Vault结构必须是：/Obsidian-Vault/notes/ 和 /Obsidian-Vault/.obsidian/ 并列存在。如果.obsidian被误拖进notes子文件夹，Remotely Save将完全忽略它。
第二步：在Remotely Save设置中填写远程路径
进入插件设置 → 远程路径栏输入：Obsidian-Vault/（结尾必须带斜杠）→ 保存 → 重启Obsidian。
第三步：触发全量同步
状态栏点击Remotely Save图标 → 选择【Force sync all files】→ 等待进度条走完 → 检查手机端.obsidian/plugins/下是否有你Mac端安装的全部插件文件夹名称。
方案三：用Syncthing点对点同步（无云中间商，但需手动管理）
① Mac端Syncthing控制台 → 点击“添加文件夹” → 路径选择你的完整Vault目录（含.obsidian）→ 文件夹ID填obsidian-vault → 保存。
② 安卓端Syncthing-Fork → 添加相同ID的文件夹 → 本地路径设为/storage/emulated/0/Obsidian-Vault → 启用双向同步。
③ 关键验证：在Mac端.obsidian/app.json里改一行注释 → 保存 → 观察安卓端对应文件是否10秒内自动更新。若延迟超30秒，检查两设备是否在同一局域网，或防火墙是否拦截8384端口。
注意：Syncthing默认同步隐藏文件，但部分安卓文件管理器会屏蔽.obsidian显示。不要凭肉眼判断是否同步成功，务必用Obsidian App内查看主题是否生效。
