Obsidian双同步攻略：用坚果云+GitHub，兼顾实时同步与版本控制

用了一段时间，放弃OneDrive了。原因一：同步总是出错；原因二：手机版OneDrive上文件夹“允许脱机使用”，居然必须要升级到高级版。这谁受得了啊！正好看到坚果云官方新出了同步插件，索性转投坚果云吧。另外顺便研究了一下GitHub 同步，打算搞一个双备份。

Obsidian 完全可以同时搭配坚果云和 GitHub 同步，既能享受坚果云的国内实时同步速度，又能借助 GitHub 实现免费版本控制与跨设备备份，一套方案解决“同步快”和“不丢档”两大需求。

今天就给大家分享一下我的「坚果云+GitHub」双同步实战方案，附一键配置脚本、冲突处理指南，Windows/macOS 通用，希望对大家有帮助。

一、方案核心逻辑（先搞懂再操作）

很多人担心双同步会导致文件混乱，其实核心逻辑很简单：让两者共用同一组本地文件，各司其职。

• 坚果云：负责「实时同步」，监测本地 Obsidian 库文件变动，秒传云端，国内多设备（电脑/手机）快速同步，操作零门槛。

• GitHub：负责「版本控制」，记录每一次笔记修改，支持回滚历史版本、跨设备（含海外设备）同步，还能防止误删、误改导致的数据丢失。

物理文件仅存于坚果云本地同步目录，双工具互不干涉，只需做好冲突管理，就能稳定运行。

二、前置准备

在执行脚本前，得先完成这3项准备工作：

1. 工具安装与配置

坚果云

• 安装坚果云客户端（登录账号），创建同步文件夹（示例路径：Nutstore/obsidian-vault），并将该文件夹设为你的 Obsidian 库路径。

• 安装GitHub Desktop，没有账号的话先注册一个。

2. GitHub 仓库准备

创建仓库

• 登录 GitHub，点击右上角的“+”，创建一个「私有仓库」（命名示例：obsidian-note），仓库类型选“Private”（保护笔记隐私）。

选择私有

3. 笔记文件就位

   确保 Obsidian 笔记已保存至坚果云同步目录（Nutstore/obsidian-vault），坚果云会自动监测文件，后续编辑后实时同步。

三、GitHub Desktop 零代码同步配置（核心步骤）

这一步很多人会用代码实现，但简单起见，还是用GitHub Desktop桌面端直接操作比较好。

第一步：首次关联（绑定仓库与本地目录）

• 打开 GitHub Desktop，登录之后，点击右侧的“Add an Existing Repository from your Local Drive…”（如果你的电脑上已经有一个 Git 仓库文件夹，可以用这个选项直接导入到 GitHub Desktop 中管理）。

• 在弹出的窗口中，找到本地的obsidian-vault 仓库，点击选中。

• 在「Local path」（本地路径）中，选择你的坚果云同步目录（Nutstore/obsidian-vault），确保仓库克隆到远程仓库下。

  关键设置

• 创建 .gitignore 文件（过滤无用文件，避免同步冗余）：

  1. 打开坚果云同步目录（obsidian-vault），新建文本文件，重命名为 .gitignore（注意前面有小数点，删除后缀 .txt）。

  2. 打开该文件，粘贴以下内容并保存，自动过滤本地配置、缓存文件，避免多设备冲突： .obsidian/workspace.json

     .obsidian/workspace-mobile.json

     .obsidian/plugins/

     .obsidian/themes/

     .obsidian/appearance.json

     .obsidian/hotkeys.json

     obsidian/config.json

     .DS_Store

     Thumbs.db

     desktop.ini

     .nutstore-conflict

第二步：日常同步操作（编辑后一键提交）

每次编辑完 Obsidian 笔记后，按以下步骤同步到 GitHub，全程2步点击，无需代码：

第一次同步仓库笔记

• 打开 GitHub Desktop，左侧选中 obsidian-note 仓库，右侧会自动显示修改的文件（即你编辑过的笔记）。

• 填写提交信息：在下方「Summary」（摘要）中输入修改说明（例：“更新笔记：2026年X月X日 整理工作文档”），「Description」（描述）可留空。

• 点击下方「Commit to main」（提交到主分支），完成本地修改记录。

• 点击右上角「Push origin」（推送至远程），等待同步完成，即可将修改同步到 GitHub 云端，实现版本备份。

补充：坚果云会自动同步本地文件，无需额外操作，编辑完笔记后，坚果云实时同步到云端，GitHub Desktop 仅需手动提交推送即可完成版本控制。

四、多设备同步配置（电脑/手机通用）

无论是多台电脑，还是手机端，都能零代码适配，确保同步一致性：

1. 移动设备（手机/平板）

   1. 安装 Obsidian 移动端，通过坚果云 WebDAV 连接同步目录（坚果云设置中开启 WebDAV，Obsidian 中添加“远程仓库”，输入 WebDAV 信息即可），实时获取笔记。

   2. 移动端无需操作 GitHub Desktop，仅需通过坚果云同步即可，版本控制可在电脑端统一管理。

最终结论

「坚果云+GitHub」可以说是目前免费方案中性价比最高的选择——坚果云解决“实时同步”的刚需，GitHub 又补上“版本更新控制”的短板，实现稳定、安全的笔记跨设备管理，再也不用担心笔记丢失。

对我这种懒得过多折腾的人来说，非常合适啦。

先用一段时间试试吧，有问题再跟大家分享！