Obsidian Git 多端同步配置指南
概述
使用 GitHub 私有仓库 + Obsidian Git 插件实现全端笔记自动同步，替代付费的 Obsidian Sync。
工作原理
本地编辑 → 自动 commit → push 到 GitHub ← pull ← 其他设备
- 自动 commit + push：每 10 分钟
- 自动 pull：每 10 分钟 + Obsidian 启动时
- 冲突处理：merge 策略
首次配置（新设备）
1. 前置条件
2. Clone 仓库
git clone https://github.com/Userwei0418/obsidian-notes.git
3. 在 Obsidian 中打开
打开 Obsidian → "Open folder as vault" → 选择 clone 下来的 obsidian-notes 文件夹
4. 信任作者并启用插件
首次打开时会提示 "Safe mode"，点击 "Turn off safe mode" 以启用社区插件。
Obsidian Git 插件会自动加载，无需额外配置。
5. 完成
插件会在后台自动 pull 最新内容，之后每 10 分钟自动同步。
手动同步命令
如果需要立即同步：
cd "/Users/zhouwei5/Documents/Obsidian Vault"
git add -A && git commit -m "手动同步" && git push
.gitignore 说明
以下内容不会被同步（避免跨设备冲突）：
| 忽略项 | 原因 |
|---|---|
.obsidian/workspace.json |
窗口布局各设备不同 |
.obsidian/plugins/*（除 obsidian-git） |
插件本体需按设备重装 |
.obsidian/themes/ |
主题按设备偏好 |
.trash/ |
回收站 |
但插件配置文件（如 data.json、manifest.json）会被同步，确保设置一致。
当前配置
- 仓库：Userwei0418/obsidian-notes（私有）
- 本地路径：
/Users/zhouwei5/Documents/Obsidian Vault - 插件版本：obsidian-git 2.39.0
- 自动同步间隔：10 分钟
- 配置日期：2026-08-27
💬 评论