如何在 macOS 上设置支持自动化同步的 Obsidian 笔记同步功能？

本文共计788个文字，预计阅读时间需要4分钟。

相关专题： 在 macOS 上配置支持自动化同步的 Obsidian 笔记环境，核心是选对同步方式、配好认证、设好自动节奏，不依赖官方付费服务也能稳定运行。下面分三步讲清楚关键操作，避开常见坑。

装好基础工具：Git + Obsidian + GitHub/Gitee 账号

obsidian 本身不带同步能力，得靠外部工具驱动。先确保这三样就位：

• Obsidian：去 obsidian.md 下载最新版（v1.12+ 更稳），安装后创建或打开你的笔记库（Vault）
• Git：终端执行 brew install git（没装 Homebrew 就先装），然后配好用户名和邮箱：
  git config --global user.name "your-name"
git config --global user.email "you@example.com"
• 远程仓库：国内推荐用 Gitee（速度快、私有库免费），国际用户可用 GitHub；新建仓库时别勾“初始化”，保持空仓

启用 Obsidian Git 插件并绑定远程库

这是自动化同步的执行中枢，配置要一次到位：

• 在 Obsidian 设置里打开「社区插件」→ 关闭安全模式 → 搜索 “Obsidian Git” → 安装并启用
• 用 Cmd + P 打开命令面板，执行 Git: Initialize a new repository，让当前 Vault 变成 Git 本地仓库
• 再执行 Git: Add a remote，填入远程地址：
  • Gitee 推荐 HTTPS 格式：https://gitee.com/用户名/仓库名.git
  • GitHub 推荐 SSH 格式：git@github.com:用户名/仓库名.git（需提前生成密钥并添加到账号）
• 首次推送前，手动提交一次：Git: Commit all staged files → 输入信息如 “init vault”，再执行 Git: Push

设置自动节奏与排除干扰文件

插件默认不自动运行，必须进设置开启定时任务，并告诉它哪些文件不用管：

• 进入插件设置页，关键几项建议这样填：
  • Auto commit-and-sync interval：10（分钟）
  • Auto pull interval：10（分钟）
  • Pull updates on startup：✅ 开启
  • Push on backup：✅ 开启
  • Commit message：建议用 vault sync {date} 方便查日志
• 在 Vault 根目录新建 .gitignore 文件，粘贴以下内容（防止缓存、临时文件污染仓库）：
  

  .obsidian/workspace.json<br>.obsidian/.trash/<br>.DS_Store<br>.obsidian/cache<br>.obsidian/plugins

• 如果用 HTTPS 远程地址，记得在插件设置里填入 Personal Access Token（Gitee/GitHub 个人令牌），否则每次 push 都会卡住

这套配置跑起来后，你改完笔记、切走做别的事，插件会在后台静默完成提交→拉取→推送全过程。不需要点任何按钮，也不用守着电脑等同步完成。