Git 同步方案：GitHub + logseq-git 插件

为什么 Git 适合 Logseq

Logseq 的数据（OG 版本）是纯 Markdown 文件——Markdown 本来就是 Git 的最好搭档：

• 文本 diff 清晰
• 冲突容易手动解决（合并时两边都保留）
• 历史完整可追溯（任意版本回滚）
• 数据完全自由（不依赖任何同步服务）

步骤一：创建 Git 仓库

在 GitHub（或 GitLab/Gitea/GitHub Desktop）上创建一个私有仓库（推荐私有，因为笔记内容是个人数据）。

步骤二：初始化本地仓库

在图谱目录下打开终端：

git init
git add .
git commit -m "Initial commit"
git remote add origin https://github.com/你的用户名/仓库名.git
git push -u origin main

注意：不要把 .git/ 目录和其他非 Markdown 文件（Logseq DB 版的索引）纳入版本控制。建议创建 .gitignore：

# Logseq 索引
logseq/db/
logseq/transit/
logseq/ide/

# 系统文件
.DS_Store
Thumbs.db

步骤三：安装 logseq-git 插件

在插件市场搜 git → 安装 logseq-plugin-git → 配置：

• 设置自动 commit 间隔（推荐 3-5 分钟）
• 设置自动 push（推荐开启）
• 设置自动 pull（推荐开启，解决多设备冲突）
• 设 commit message 模板（比如 Auto sync at {{time}}）

步骤四：多设备配置

在第二台设备上：

1. 克隆仓库到本地（git clone https://github.com/...）
2. 用 Logseq 打开克隆的目录作为图谱
3. 同样安装 git 插件，配置相同

多设备使用同一仓库时：

• 同一时间只能在一台设备上打开 Logseq（不然可能同时写导致冲突）
• 关掉 Logseq 前等几秒让 git push 完成
• 打开 Logseq 后等几秒让 git pull 拉到最新

冲突处理

当 git pull 遇到冲突时：

1. Git 会在文件里插入 <<<<<<< ======= >>>>>>> 标记
2. 打开冲突文件手动保留两边的内容（Markdown 里两边内容都通常有用）
3. 重新 commit + push

这比 Logseq Sync 麻烦，但你完全控制每一步。

实战：Windows 桌面 + MacBook + iPhone

• Windows 桌面：主要写作设备，安装 git 插件自动同步
• MacBook：辅助写作，偶尔打开，git pull 拉最新
• iPhone：移动端 App 暂不支持直接 git，但可以通过 GitHub CLI 或第三方 App 访问仓库里的 Markdown 文件

移动端是 Git 方案的短板——如果你需要移动端原生体验，Logseq Sync 更好。

优缺点总结