基于Git实现跨系统、多设备的Obsidian Vault同步（免费、高效、稳定）

原创已于 2024-11-12 17:27:39 修改 · 1.8k 阅读

CC 4.0 BY-SA版权

文章标签：

于 2024-11-12 17:20:10 首次发布

研一rookie，使用Obsidian来管理包含日报、论文、阅读笔记等在内的工作流，希望在自己的笔记本和实验室的办公电脑上同步自己的Vault，获得随时可记、随处可读、设置一致的流畅体验。

注意：在Ubuntu下应使用Appimage的方式安装Obsidian，这是Obsidian-Git插件全面支持且推荐的安装方式

以原设备为Windows设备，将Vault克隆到Ubuntu上并实现两设备的日常同步为例

从Git的官方网站下载最新的官方版本
在这里插入图片描述

习惯使用winget的朋友也可以在命令行或Powershell中输入如下代码来安装Git：
winget install --id Git.Git -e --source winget

打开终端（Ctrl+Alt+T），输入如下代码：
$ sudo apt install git-all

如果你是初次使用Git，需要配置用户基本信息，这不是本文主要讨论的内容，请参阅参考资料1。

在需要进行版本控制的文件夹单击右键打开Git Bash
初始化Git仓库
$ git init
该命令将创建一个名为 .git 的子目录，这个子目录含有你初始化的 Git 仓库中所有的必须文件，这些文件是Git 仓库的骨干。但在这个时候仅做了一个初始化的操作，项目里的文件还没有被跟踪。通过 git add 命令来指定所需的文件来进行追踪。然后执行git commit操作。

$ git add YOUR_FILE
$ git add YOUR_DIRECTORY/
$ git commit -m 'initial project version'

此时使用$ git status命令查看，会发现所有已跟踪文件在上次提交后都未被更改。现在可以将commit后的仓库推送至远程了。
在这里插入图片描述

git remote add <shortname> <url>

其中shortname是你自己给远程仓库起的简洁的别名，url是你远程仓库的链接
然后运行$ git remote -v可以看到远程仓库添加成功
在这里插入图片描述

我给远程仓库的别名是origin，我在远程仓库的默认分支是master，则我可以在Git Bash中运行如下代码来完成推送：

$ git push origin master

运行后会弹出身份验证，可以通过浏览器进行授权（可以使用移动端的Github，也可以使用账号密码认证，跟着提示做就好），也可以通过生成的Personal access token认证（后文会提到）
推送成功会有如下类似的显示：
在这里插入图片描述

前述操作已经成功实现了远端同步，但并不简洁方便，使用插件来将Git的操作集成在Obsidian里

打开Obsidian，使用Ctrl+P打开命令菜单，搜索并选择”Git:clone an existing remote repo“

按如下方法组合你的Token和url：
在url的https://后插入你的Token＋@
形如：https://ghp_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX@github.com/YOUR_USERNAME/YOUR_PROJECT.git
按提示选择克隆的目标文件夹
静待克隆，直到出现克隆完成，重新启动的提示
重启Obsidian，享受丝滑的同步体验！