Obsidian同步方案对比：为什么Git更适合管理笔记库？

最近我又研究了一下 Obsidian 的 Git 插件，虽然配置起来有点繁琐，但用起来确实很顺手。下面和大家分享具体的配置方法。

我第一次接触 Obsidian 是在 2024 年，当时看了《Obsidian 初体验》这篇文章才了解到这个工具。这几年主要在电脑上使用，移动端因为同步问题用得比较少。

之前也尝试过 Syncthing 和坚果云等方案，但总有些不太顺手的地方。一旦体验不佳，慢慢地就不想用了，手机端也就成了摆设，浪费了不少时间。

最近重新折腾了 Obsidian 的 Git 插件，虽然需要花点功夫配置，但确实很适合我的使用习惯。

接下来详细介绍如何配置和使用。

环境

PC 端：Mac

移动端：安卓

使用的插件和工具

1. PC 端 Git 插件

2. 移动端：GitSync、Termux

PC 端配置步骤

1. 在 Gitee（也可以使用 GitHub）上创建存放 Obsidian 笔记的仓库

2. 在 Obsidian 的根目录添加 .gitignore 文件，内容如下：

.obsidian/
.stfolder/
.stfolder.*
# 忽略系统文件
.DS_Store
Thumbs.db
desktop.ini
# 忽略备份文件
*.bak
*.tmp
# 特殊配置：保留核心插件配置（可选）
# Ignore Smart Environment folder
.smart-env
.trash/
node_modules/
.obsidian-git-log.txt
*.swp
.directory

3. 在 PC 端的 Obsidian 中安装 Git 插件

4. 将笔记仓库推送到 Gitee，并在 Obsidian 中安装 Git 插件并进行配置，主要设置了打开仓库时自动拉取最新的笔记内容

移动端配置步骤

1. 在移动端安装 Obsidian、Termux、GitSync

2. 在手机 documents 目录中创建 obsidian-mobile 文件夹

3. 在 Gitee 生成个人访问令牌，路径：设置 → 私人令牌 → 生成新令牌，必须勾选 projects 权限（用于仓库操作）。令牌生成出来后需要及时复制保存，否则窗口关闭后就无法查看了

4. 有了令牌后笔记仓库的地址如下：

https://oauth2:令牌@gitee.com/xxxx/obsidian-sync.git

5. 在 Termux 中进入到 obsidian-mobile 目录，执行以下命令拉取笔记仓库

git clone https://oauth2:令牌@gitee.com/xxxx/obsidian-sync.git

6. 打开移动端的 Obsidian，选择 obsidian-mobile/obsidian-sync 目录作为 vault 的目录，设置完成后，就能看到笔记内容了

7. 因为安卓版本的 Obsidian 的 Git 插件不太稳定，所以同步使用 GitSync 这个工具。在 GitSync 中设置仓库目录和远程地址

仓库目录：documents/obsidian-mobile/obsidian-sync

远程地址：https://oauth2:令牌@gitee.com/xxxx/obsidian-sync.git

操作模式

1. 在 PC 端完成一轮笔记修改后，或者要长时间离开电脑时，顺手使用 Git 插件将修改内容推送到服务端

2. 在手机上使用时，先打开 GitSync 同步，再打开 Obsidian；修改完成后，再次使用 GitSync 同步即可

3. 看似有点繁琐，但这其实是程序员的日常常规操作

4. 尽量不要在没有提交推送的情况下同时在 PC 端和移动端修改同一个文件，否则会出现冲突。解决冲突的方式和写代码时完全一致。比如下图就是出现冲突时的显示，将冲突部分修改为最终版本提交推送即可

5. 之所以最终还是选择了使用 Git 的方式，主要还是因为它熟悉且可控

最后

同步方式有很多种，选择自己喜欢的就好。