Obsidian三端同步方案：Github+坚果云实践

1. 为什么需要三端同步方案

在知识管理领域，Obsidian凭借其本地优先、Markdown友好的特性迅速崛起。但纯本地存储带来的最大痛点就是多设备同步问题——你不可能永远只在一台电脑上工作。我尝试过多种同步方案后，最终选择了Github+坚果云这套组合拳，原因很简单：

• 版本控制刚需：写笔记最怕误删或改乱内容，Git的版本回溯能力能完美解决这个问题。上周我不小心用批量替换把50个文件的标题全改错了，直接git reset就恢复了。
• 跨平台需求：Windows写方案、Mac做设计、iPad临时查阅，三端实时同步是基本要求。坚果云的增量同步特性让手机端也能快速查看最新改动。
• 成本敏感：Obsidian官方同步服务$8/月，而Github免费私有库+坚果云免费15GB完全够用。我的知识库运营3年才用了不到3GB空间。

实测这套方案的同步延迟在30秒内（取决于坚果云同步速度），完全满足日常使用。下面拆解具体实现步骤。

2. 环境准备与基础配置

2.1 Obsidian基础设置

首次使用Obsidian需要特别注意：

1. 创建新库时选择空文件夹（后续会初始化为Git仓库） 2. 设置 → 文件与链接 → 默认新建文件位置选"库根目录" 3. 设置 → 编辑器 → 开启"自动保存"和"自动配对符号"

重要提示：不要使用系统自带的加密文件夹（如Windows的OneDrive加密目录），会导致坚果云同步异常。

2.2 Github仓库初始化

在Github创建私有库时有两个关键设置：

# 本地初始化命令（在Obsidian库目录执行） git init git branch -M main git remote add origin git@github.com:yourname/repo.git

建议添加的.gitignore文件内容：

.obsidian/workspace .obsidian/workspace-mobile .trash/

2.3 坚果云同步配置

在坚果云客户端设置中需要：

1. 添加Obsidian库文件夹为同步目录
2. 高级设置 → 排除临时文件：*.tmp和*.lock
3. 同步策略选"实时同步"

3. 自动化同步方案实现

3.1 Git自动化提交脚本

在库根目录创建.git/hooks/post-commit文件（Windows需去掉扩展名）：

#!/bin/sh git push origin main

赋予执行权限后，每次本地commit都会自动推送到远程。实测这个方案比Obsidian的Git插件更稳定，不会出现冲突锁定问题。

3.2 多设备同步策略

• 主力电脑：安装完整的Git环境，负责解决可能的合并冲突
• 移动设备：通过坚果云App直接查看文件，避免在手机端操作Git
• 备用电脑：使用git pull --rebase避免产生多余merge commit

3.3 冲突处理方案

当出现同步冲突时（常见于多设备同时编辑）：

1. 坚果云会生成conflict后缀文件
2. 使用VS Code的GitLens插件可视化对比差异
3. 手动合并后执行：

git add . git commit -m "resolve conflicts"

4. 高级技巧与性能优化

4.1 大文件处理方案

对于PDF等二进制文件：

1. 创建assets目录专门存放
2. 使用Git LFS管理（需额外安装）：

git lfs install git lfs track "assets/*.pdf"

4.2 历史版本清理

当.git目录过大时（超过500MB）：

git gc --aggressive --prune=now git repack -a -d --depth=250 --window=250

4.3 移动端优化技巧

在Android上使用Termux实现Git同步：

pkg install git cd ~/Nutstore Files/MyVault git config --global user.email "mobile@example.com"

5. 常见问题解决方案

5.1 同步失败排查流程

1. 检查坚果云托盘图标状态
2. 查看%APPDATA%\Nutstore\db下的日志文件
3. 重启坚果云服务：net stop Nutstore && net start Nutstore

5.2 Git常见错误处理

• 认证失败：改用SSH密钥替代HTTPS协议
• 推送被拒绝：先执行git pull --rebase
• 大文件错误：检查是否漏配Git LFS

5.3 性能问题优化

当库内文件超过5000个时：

1. 关闭Obsidian的"自动更新内部链接"功能
2. 在.obsidian/app.json中设置：

"fileWatcherDelay": 5000

这套方案我已经稳定使用2年多，经历过三次设备更换和两次系统重装，所有笔记数据完好无损。最关键的是养成定期git status检查的习惯，就像每天出门前检查手机钥匙一样自然。对于技术型笔记，我还会给重要commit打tag，比如#v1.0-算法优化方便后续回溯。