在 macOS 上可通过 Git + Obsidian Git 插件实现免费自动化同步：先安装 Obsidian、Git 并配置 Gitee/GitHub 仓库；再启用插件、初始化本地仓库、添加远程地址并首次提交；最后设置自动提交/拉取间隔、开启启动拉取与备份推送，并配置 .gitignore 和 Personal Access Token。在 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 都会卡住
