---
title: "05-Obsidian-Git多端同步"
created: 2026-08-27
tags:
  - 小技能
---

# Obsidian-Git多端同步

> 📚 Tools 区唯一完整迁存的笔记（2026-08-27 配置）。用 GitHub 私有仓库 + Obsidian Git 插件实现全端笔记自动同步，替代付费的 Obsidian Sync。

## 概述

```
本地编辑 → 自动 commit → push 到 GitHub ← pull ← 其他设备
```

- **自动 commit + push**：每 10 分钟
- **自动 pull**：每 10 分钟 + Obsidian 启动时
- **冲突处理**：merge 策略

## 首次配置（新设备）

### 1. 前置条件

- 安装 [Obsidian](https://obsidian.md/download)
- 安装 [Git](https://git-scm.com/)
- GitHub 账号并已登录

### 2. Clone 仓库

```bash
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 分钟自动同步。

## 手动同步命令

如果需要立即同步：

```bash
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](https://github.com/Userwei0418/obsidian-notes)（私有）
- **本地路径**：`/Users/zhouwei5/Documents/Obsidian Vault`
- **插件版本**：obsidian-git 2.39.0
- **自动同步间隔**：10 分钟
- **配置日期**：2026-08-27

> 💡 与本库重制工作的关系：2-Learning 的重制成果也会随这套同步进入 GitHub 私有仓库，等于自带异地备份。

---
⬅️ [[04-Obsidian使用技巧]] 🏠 [[00-小技能]] ➡️ [[06-Obsidian探索与配置]]