Obsidian Git：把 Git 那一整套东西，搬进了你的笔记库里

有段时间我天天在几台电脑之间来回切 Obsidian，体验特别像搬砖：这台改一笔，那台忘了同步，一不小心就多出几个冲突文件，名字还都叫 something(1).md。后来我干脆放弃同步，靠自己记“我到底在哪台电脑改过”，结果可想而知，经常丢内容。作为写代码习惯用 Git 的人，那段时间我真的很想在 Obsidian 里直接按个键就 commit + push，别再去终端折腾。直到我装上 Obsidian Git 这个插件，才有了一种“这才是人过的日子”的感觉。

简单说，它就是把 Git 那一整套东西，搬进了你的笔记库里：自动 commit、定时同步、看历史、看 diff，全在 Obsidian 界面里搞定，不用再来回切终端或 Git 客户端。如果你本来就用 VS Code 的 Source Control 面板，那种感觉几乎是一模一样，只是对象从代码换成了你的笔记。

插件最爽的地方就是“懒人友好”。设好以后，它可以定时帮你做三件事：commit 当前改动、pull 远程更新、push 到远程仓库。你可以设成每 10 分钟、30 分钟跑一遍，写完关电脑，心里很踏实：不管是崩溃也好，误删也好，只要 Git 还在，东西就回得来。再加上一个「启动时自动 pull」，你在另一台电脑打开 Obsidian，笔记就先拉一遍远程的，减少很多冲突。

它还提供了几个很关键的视图。一个是 Source Control 视图，可以看到哪些文件被改了，想“后悔药”就右键丢弃，也可以只暂存部分文件再提交；一个是 History 视图，列出每次提交的记录，需要的话还能把作者、时间都显示出来；还有 Diff 视图，直接对比当前文件的改动，绿色红色那种经典 Git diff 味道，看一眼就懂自己刚刚删了什么、加了什么。

如果你笔记放在 GitHub 上，它还能一键在浏览器打开当前文件，或者打开这个文件的历史记录，算是给“公开笔记”玩家一个小福利。想要更精细的单文件历史，对某一篇笔记做时间机器那种追踪，再配合一下 Version History Diff 插件就更香了。

说完好处，再来讲讲怎么装，毕竟这是很多人卡住的地方。

大前提：你的 Obsidian 笔记库，最好已经是一个 Git 仓库（或者你准备让插件帮你初始化一个）。简单流程可以这样走：

1. 打开 Obsidian 设置 → 社区插件，把安全模式关掉。
2. 点击“浏览”，搜索 Obsidian Git。
3. 点安装，然后启用插件。
4. 在设置里找到「Obsidian Git」，进去就能看到一堆配置项。

如果你的库还没变成 Git 仓库，可以直接用插件里的 Initialize a new repo 命令，一键初始化本地仓库。接着用 Edit remotes 设置远程地址，把 GitHub/GitLab 的仓库 URL 填进去，https 或 SSH 看你自己习惯，前提是本地能正常访问那个仓库。

接下来几个建议的设置，可以参考一下：

• Auto pull on startup 打开，这样每次启动先拉最新的。
• 自动 commit 和同步间隔可以先调大一点，比如 30 分钟，或者干脆关掉，改用手动 Commit-and-sync 命令。
• 初期建议只在一台主力设备上开自动同步，其他设备先手动 pull/commit，等自己搞清 Git 的节奏再放开。
• 有些不想进版本库的大附件、导出文件，可以用命令  Add file to .gitignore 加进去，仓库会轻松很多。

插件里对应的命令其实挺多，但日常你可能只会用到几条：

• Commit-and-sync：一键提交并拉取、推送，日常收工就靠它。
• Open diff view：当前文件到底改了哪几句，一眼看清。
• Discard all changes：今天写崩了、不想要了，整个仓库回到上一次提交。
• Open source control view：像 VS Code 那样在侧边栏管理变更。
• Open history view：看看自己这几天到底写了多少次 commit，有时候还能顺便审判下自己摸鱼没。

我现在的习惯是：把 commit message 写得尽量清楚，比如 daily notes 2026-01-08、 refactor MOC for reading 这种，哪天回头翻历史，至少知道当时在干嘛。以前图省事，所有自动提交都是同一个“vault backup”消息，后来想找某次改动的时候，整个人都在和过去的自己吵架，只能一条条点开 diff 看。

如果你本身就用 Git 管代码，那这个插件几乎是必装；如果完全没接触过 Git，也可以把它当作学备份思维的入口，只是一定要慢一点来：先在一个小 vault 里试试，搞清楚 commit、pull、push 的节奏，再把自己主力笔记库交给它。对我来说，它让 Obsidian 不再只是一堆散落的 markdown 文件，而是一个可以“后悔、回档、有时间线”的第二大脑，这种安全感，换回去我是不愿意的。