1. 为什么选择Git同步Obsidian如果你和我一样是个笔记狂魔肯定遇到过这样的烦恼在电脑上写的笔记出门用手机却看不到最新版本。传统的云同步方案比如OneDrive虽然方便但存在几个硬伤同步冲突时可能丢数据、版本回溯困难、商业云服务有隐私顾虑。我去年就经历过一次OneDrive同步失败导致半个月的笔记修改全部丢失。Git作为程序员最熟悉的版本控制工具其实特别适合用来同步Obsidian。它有几个天然优势版本控制每次修改都有完整历史记录可以精确回溯到任意时间点冲突处理当多设备修改同一文件时Git会保留双方修改内容纯文本友好Obsidian的笔记都是Markdown文件正是Git最擅长的类型隐私可控数据完全掌握在自己手中不需要依赖第三方云服务实测下来我的2000笔记仓库用Git同步后跨设备修改再也没出现过数据丢失。更惊喜的是由于Git的增量传输特性同步速度反而比OneDrive更快——特别是当只修改了几个文件时Git只需要传输差异部分。2. 电脑端Git环境配置2.1 基础Git环境搭建Windows下的配置其实非常简单我推荐用Git for Windows这个官方工具包。安装时记得勾选将Git添加到系统PATH选项这样后面在命令行操作会更方便。装好后打开PowerShell测试git --version如果看到版本号输出就说明安装成功。接下来需要配置全局用户信息git config --global user.name 你的名字 git config --global user.email 你的邮箱这些信息会记录在每次提交中建议使用和GitHub账号相同的邮箱。2.2 Obsidian仓库初始化打开你的Obsidian库所在文件夹右键选择Git Bash Here然后执行git init git add . git commit -m 初始提交这样就完成了本地仓库的创建。如果想备份到GitHub先在网站上新建一个私有仓库切记设为private然后按照提示添加远程仓库git remote add origin gitgithub.com:用户名/仓库名.git git push -u origin main这里有个小技巧建议在.gitignore文件中添加以下内容避免同步不必要的文件# Obsidian特定文件 .obsidian/workspace.json .obsidian/plugins/obsidian-git/data.json .obsidian/plugins/obsidian-git/backup/ .trash/3. 安卓端MGit实战配置3.1 安卓Git环境搭建安卓端我强烈推荐MGit这款开源工具它比官方Git更适合移动端操作。安装方式有两种通过F-Droid应用商店需先添加清华镜像源直接下载APK安装包配置时要注意几个关键点将工作目录设置为手机上的Obsidian笔记位置通常是Documents/Obsidian在设置中开启自动CRLF转换避免Windows和Linux换行符差异关闭严格主机密钥检查否则可能遇到连接问题3.2 SSH密钥配置安全连接GitHub必须配置SSH密钥。在MGit中操作特别简单进入SSH密钥管理点击生成新密钥默认RSA 2048位就够用复制公钥内容以ssh-rsa开头的那段登录GitHub在Settings → SSH and GPG keys中添加新密钥测试连接是否成功ssh -T gitgithub.com看到Hi 用户名!的欢迎信息就说明配置正确。3.3 仓库克隆与同步在MGit中克隆仓库时一定要使用SSH地址格式gitgithub.com:用户名/仓库名.git。我建议开启自动记住密码选项这样后续操作就不需要重复输入了。日常使用流程修改笔记前先执行Pull获取最新版本完成编辑后执行Add → Commit → Push三部曲冲突时会提示合并按照界面指引操作即可实测在4G网络下同步100KB左右的修改只需要2-3秒比云盘方案快得多。4. 高级技巧与故障排查4.1 自动化同步方案虽然手动同步已经很可靠但我们可以做得更好。在电脑端可以创建简单的批处理脚本echo off cd /d 你的Obsidian路径 git add . git commit -m 自动提交 %date% %time% git push然后用Windows任务计划程序设置每小时自动执行。安卓端则可以用MacroDroid等自动化工具在打开Obsidian时自动执行Pull。4.2 常见问题解决问题1MGit提示Permission denied检查SSH密钥是否正确添加到GitHub重新生成密钥对有时旧密钥会失效确保GitHub仓库是私有库公开库有时会有权限问题问题2同步时出现CRLF警告在电脑端执行git config --global core.autocrlf true在MGit设置中开启自动换行符转换问题3冲突文件处理不要惊慌Git会保留双方修改冲突文件会包含和标记用文本编辑器手动合并后重新提交4.3 性能优化建议当笔记仓库很大时超过1GB可以采取这些优化措施定期执行git gc压缩仓库历史使用git shallow clone只克隆最近版本将附件目录设为独立Git仓库启用Git的fsmonitor功能加速状态检查这套方案我已经稳定使用8个月累计完成超过2000次跨设备同步真正实现了写笔记自由。现在无论在地铁上用手机速记还是在家用电脑深度写作所有内容都能实时保持同步再也不用担心商业云服务的各种限制。
