Obsidian 学习笔记

Appearance

Obsidian Git 同步教程 ​

Obsidian Git 是最受欢迎的同步插件之一，通过 Git 版本控制系统实现笔记的备份、同步和版本管理。

为什么选择 Git 同步？ ​

优势说明
完全免费无需付费订阅
版本历史可回退到任意历史版本
多平台支持Windows、macOS、Linux、iOS、Android
冲突处理Git 成熟的冲突解决机制
隐私安全数据存储在你自己的仓库

前置要求 ​

安装 Git ​

Windows:

  1. 访问 git-scm.com
  2. 下载并运行安装程序
  3. 安装时保持默认选项即可

macOS:

bash
# 使用 Homebrew
brew install git

# 或使用 Xcode 命令行工具
xcode-select --install

Linux:

bash
# Ubuntu/Debian
sudo apt install git

# Fedora
sudo dnf install git

# Arch Linux
sudo pacman -S git

配置 Git 用户信息 ​

bash
git config --global user.name "你的名字"
git config --global user.email "your@email.com"

注册 GitHub/Gitee 账号 ​

推荐使用：

  • GitHub - 国际平台，稳定可靠
  • Gitee - 国内平台，访问更快
  • GitLab - 可自建服务器

安装 Obsidian Git 插件 ​

步骤一：开启第三方插件 ​

  1. 打开「设置」→「第三方插件」
  2. 关闭「安全模式」
  3. 点击「浏览」

步骤二：安装插件 ​

  1. 搜索「Obsidian Git」
  2. 点击「安装」
  3. 安装完成后点击「启用」

步骤三：配置插件 ​

进入「设置」→「第三方插件」→「Obsidian Git」

基础配置 ​

自动备份设置 ​

设置项推荐值说明
Vault backup interval (minutes)5每 5 分钟自动备份
Auto backup after file change关闭避免频繁提交
Auto pull interval (minutes)5每 5 分钟自动拉取

提交信息设置 ​

设置项推荐值
Commit messagevault backup:
Commit message on backup开启

排除文件 ​

建议在 .gitignore 文件中添加：

gitignore
# Obsidian 工作区配置
.obsidian/workspace.json
.obsidian/workspace-mobile.json

# 系统文件
.DS_Store
Thumbs.db

# 临时文件
*.tmp
*.temp

创建远程仓库 ​

GitHub 创建步骤 ​

  1. 登录 GitHub
  2. 点击右上角「+」→「New repository」
  3. 填写仓库信息：
    • Repository name: obsidian-notes
    • Description: 我的 Obsidian 笔记
    • 选择 Private（私有仓库）
  4. 点击「Create repository」

初始化本地仓库 ​

在 Obsidian 仓库目录执行：

bash
# 进入笔记目录
cd /path/to/your/vault

# 初始化 Git
git init

# 添加远程仓库
git remote add origin https://github.com/你的用户名/obsidian-notes.git

# 添加所有文件
git add .

# 首次提交
git commit -m "初始化笔记仓库"

# 推送到远程
git branch -M main
git push -u origin main

日常使用 ​

自动同步 ​

配置完成后，插件会自动：

  1. 定时提交本地更改
  2. 定时拉取远程更改
  3. 自动推送提交

手动同步 ​

使用命令面板（Ctrl/Cmd + P）：

命令功能
Obsidian Git: Create backup创建备份并推送
Obsidian Git: Pull拉取远程更改
Obsidian Git: Push推送本地更改
Obsidian Git: Open view打开 Git 面板

快捷键设置 ​

建议设置以下快捷键：

命令快捷键
创建备份Ctrl/Cmd + Shift + S
拉取更改Ctrl/Cmd + Shift + P

多设备同步 ​

桌面端设置 ​

每台电脑都需要：

  1. 安装 Git
  2. 克隆仓库或初始化
  3. 安装 Obsidian Git 插件
  4. 配置自动同步

移动端设置 ​

iOS (使用 Working Copy):

  1. 安装 Working Copy 应用
  2. 克隆 GitHub 仓库
  3. 设置「文件夹」共享给 Obsidian
  4. 在 Obsidian 中打开共享文件夹

Android (使用 Termux):

bash
# 安装 Termux
# 在 Termux 中执行：
pkg install git
git clone https://github.com/你的用户名/obsidian-notes.git

版本回退 ​

查看历史版本 ​

bash
# 查看提交历史
git log --oneline

# 查看特定文件的历史
git log --oneline -- 文件名.md

回退到历史版本 ​

bash
# 回退到特定提交
git checkout 提交哈希

# 创建新分支保留当前状态
git checkout -b backup-branch

# 返回最新版本
git checkout main

使用插件回退 ​

  1. 打开 Git 面板
  2. 点击「历史」标签
  3. 选择要回退的提交
  4. 点击「还原」

冲突处理 ​

冲突产生原因 ​

当两台设备同时修改同一文件时，Git 无法自动合并，需要手动解决。

冲突标记 ​

<<<<<<< HEAD
这是本地的修改
=======
这是远程的修改
>>>>>>> origin/main

解决冲突 ​

  1. 打开有冲突的文件
  2. 编辑冲突部分，保留需要的内容
  3. 删除冲突标记
  4. 提交解决后的文件

预防冲突 ​

  • 保持频繁同步
  • 避免在多设备同时编辑同一文件
  • 使用 .gitignore 排除工作区配置

高级配置 ​

SSH 密钥认证 ​

避免每次输入密码：

bash
# 生成 SSH 密钥
ssh-keygen -t ed25519 -C "your@email.com"

# 查看公钥
cat ~/.ssh/id_ed25519.pub

# 将公钥添加到 GitHub Settings → SSH Keys

更改远程地址：

bash
git remote set-url origin git@github.com:用户名/obsidian-notes.git

分支策略 ​

bash
# 创建实验分支
git checkout -b experiment

# 合并分支
git checkout main
git merge experiment

# 删除分支
git branch -d experiment

大文件处理 ​

对于大型附件，建议：

  1. 使用 Git LFS:
bash
git lfs install
git lfs track "*.pdf"
git lfs track "*.mp4"
  1. 或使用图床存储图片

常见问题 ​

推送失败 ​

问题： fatal: unable to access

解决：

bash
# 检查网络连接
# 使用代理
git config --global http.proxy http://127.0.0.1:7890

# 或使用 Gitee 镜像

合并冲突 ​

问题： 文件内容冲突

解决：

  1. 手动编辑冲突文件
  2. 或使用 git mergetool 工具

历史记录过大 ​

问题： 仓库体积太大

解决：

bash
# 清理历史记录
git filter-branch --force --index-filter \
  "git rm --cached --ignore-unmatch 附件/*.mp4" \
  --prune-empty --tag-name-filter cat -- --all

移动端同步慢 ​

解决：

  • 减少大文件数量
  • 使用 Wi-Fi 同步
  • 调整同步间隔

最佳实践 ​

  1. 定期检查同步状态 - 确保 Git 面板无错误提示
  2. 写有意义的提交信息 - 便于追踪变更
  3. 定期清理历史 - 删除不必要的旧版本
  4. 保持网络稳定 - 同步前确保网络连接
  5. 备份重要笔记 - 关键内容单独备份

相关链接 ​

最后更新：2026年2月27日编辑此页反馈问题