1. 为什么选择 Git 来同步你的 Obsidian 知识库如果你和我一样是个重度笔记依赖者从工作项目到生活灵感什么都往笔记里塞那你肯定遇到过这个烦恼在电脑上刚整理好的笔记出门在外想用手机看一眼或者补充点想法却发现两边内容对不上。我之前也试过不少同步方案比如官方的 Obsidian Sync功能确实强大但订阅制对长期使用来说是一笔不小的开销。也折腾过 iCloud 或 OneDrive 这类网盘但经常遇到同步冲突或者文件锁定问题尤其是在 Windows 和 iOS 这两个不同生态的设备之间体验总是不那么“丝滑”。后来我把目光投向了 Git。没错就是程序员们用来管理代码版本的那个工具。你可能觉得这听起来有点“硬核”但实际用下来我发现它简直是 Obsidian 跨平台同步的“隐藏神器”。首先它完全免费依托 GitHub、Gitee 这样的平台你的笔记仓库就是你的私人代码库。其次它的核心是版本控制这意味着你每一次的修改都有历史记录万一哪天手滑误删了某个重要段落可以轻松地“穿越”回去找回来这种安全感是普通同步工具给不了的。最后它的可靠性经过了全球开发者的亿万次验证只要你配置得当同步过程非常稳定。当然最大的挑战在于如何在非开发者的日常使用场景下让这套“专业工具”变得简单易用。这正是我这篇文章想帮你解决的我将手把手带你用最清晰、最“小白友好”的步骤在 Windows 电脑和 iPhone 之间搭建一套基于 Git 的 Obsidian 无缝同步工作流。你会发现一旦打通这套系统就像给你的知识库装上了自动档你只需要专注于思考和记录剩下的同步和备份Git 会默默帮你搞定。2. 搭建前的准备工作理清思路备好工具在开始动手之前我们先把整个同步的“蓝图”和需要的“工具”理清楚。整个流程的核心思想是将你的 Obsidian 笔记库Vault变成一个 Git 仓库然后通过一个云端 Git 服务如 GitHub作为中转站让 Windows 和 iOS 设备都能从这个中转站拉取和推送更新。听起来有点像“云端U盘”但比那智能得多。为了实现这个蓝图我们需要在两端准备好相应的环境。别担心每一步我都会给出详细的指引和截图确保你能跟上。Windows 端需要准备什么Obsidian 本体这个不用说你已经有了一个正在使用的笔记库。如果还没有去官网下载安装新建一个库即可。Git 环境这是让 Windows 电脑能听懂 Git 命令的关键。你需要下载并安装 Git for Windows。安装过程基本一路“Next”就行记得在“Adjusting your PATH environment”这一步选择“Git from the command line and also from 3rd-party software”这样系统在任何地方都能识别 Git 命令。GitHub 账户我们将使用 GitHub 作为免费的云端仓库。如果你没有去 GitHub 官网注册一个完全免费。国内用户如果访问 GitHub 速度不理想也可以使用Gitee码云操作逻辑几乎完全一样后续命令中的github.com替换成gitee.com即可。iOS 端需要准备什么Obsidian App在 App Store 搜索并安装 Obsidian。这是你在手机上查看和编辑笔记的窗口。Working Copy App这是整个方案在 iOS 端的“灵魂”。它是一个功能强大的 Git 客户端让我们能在 iPhone 上直接操作 Git 仓库。在 App Store 搜索“Working Copy”安装它有免费版免费版功能对我们基础同步拉取来说已经足够。付费可以解锁推送Push等功能我们后面会讨论。把这两端的软件都准备好之后我们就可以开始正式的配置了。整个过程就像是搭积木我们先在 Windows 端把积木仓库搭好并放到云端GitHub然后再用 iPhone 上的 Working Copy 把云端的积木完整地“搬”到手机里。3. Windows 端核心配置让 Obsidian 学会自动“提交”万事俱备现在我们从电脑端开始这是整个同步系统的“控制中心”。我们的目标是把本地已有的 Obsidian 笔记库初始化成一个 Git 仓库并让它能通过插件半自动或全自动地与云端同步。3.1 创建并配置你的云端仓库GitHub/Gitee首先我们需要在云端建立一个“据点”。打开 GitHub 网站并登录点击页面右上角的 “” 号选择 “New repository”。在创建仓库的页面有几项需要特别注意Repository name给你的仓库起个名字比如my-obsidian-vault。Description选填可以简单描述一下。Public / Private务必选择 “Private”私有。你的笔记很可能包含个人隐私或工作机密设置为私有仓库至关重要。Initialize this repository with...这里非常重要不要勾选 “Add a README file”也不要勾选 “Add .gitignore” 和 “Choose a license”。我们要创建一个完全空白的仓库然后由我们本地的内容去初始化它。如果勾选了这些反而会增加后续操作的复杂度。点击 “Create repository” 按钮你的空白云端仓库就创建好了。创建成功后页面会显示一个仓库的 HTTPS 链接格式类似https://github.com/你的用户名/my-obsidian-vault.git。先把这个链接复制下来稍后我们会用到。3.2 将本地笔记库变为 Git 仓库并关联云端接下来我们回到你的 Windows 电脑。找到你的 Obsidian 笔记库所在的文件夹。在这个文件夹的空白处按住 Shift 键的同时点击鼠标右键在弹出的菜单中你会看到“在此处打开 PowerShell 窗口”或“在此处打开命令提示符窗口”或者如果你安装了 Git Bash也会看到“Git Bash Here”。选择任何一个命令行窗口都可以。在弹出的黑色命令窗口中我们将依次输入几条命令来初始化并关联仓库git init这条命令会在你当前的笔记文件夹内创建一个隐藏的.git文件夹标志着这里变成了一个 Git 仓库。git add .这条命令告诉 Git“把我这个文件夹里所有新文件、改动的文件都暂时存起来暂存区准备提交。” 那个点.代表当前目录下的所有文件。git commit -m Initial Commit这条命令是真正的“存档”。它将刚刚暂存的所有改动打包成一个版本记录并附上说明“Initial Commit”初始提交。-m后面的信息你可以自己修改比如“首次提交笔记库”。git remote add origin https://github.com/你的用户名/my-obsidian-vault.git这条命令为你本地的仓库添加一个“远程仓库”的地址并给它起个别名叫origin。后面那串链接就粘贴你刚才从 GitHub 复制的 HTTPS 链接。git push -u origin master这是最后一步也是关键一步将你本地刚刚提交的“初始提交”版本推送到远程仓库origin的master分支上。-u参数是设置上游关联这样以后你在这个分支上直接git push就可以了。这里有一个非常重要的坑点现在很多 Git 服务商的默认分支名是main而不是master。你可以在 GitHub 仓库页面的 “Settings” - “Repositories” - “Repository default branch” 里查看。如果你的默认分支是main那么最后一条命令应该改为git push -u origin main。如果不确定两条命令都试一下错误的那条会提示你分支不存在。执行完git push后可能需要你输入 GitHub 的用户名和密码注意密码现在一般要求使用 Personal Access Token你可以在 GitHub 的 Settings - Developer settings - Personal access tokens 中生成一个并赋予 repo 权限。输入正确后命令行会显示上传进度。完成后刷新你的 GitHub 仓库页面就能看到所有笔记文件都安然无恙地躺在那里了3.3 安装并配置 Obsidian Git 插件实现自动化手动敲命令毕竟麻烦好在 Obsidian 社区有强大的插件生态。我们要安装的就是Obsidian Git插件它能将很多 Git 操作集成到 Obsidian 内部甚至实现定时自动备份。打开 Obsidian进入设置Settings找到“社区插件”Community plugins关闭“安全模式”Restricted mode然后点击“浏览”Browse。在搜索框里输入 “obsidian git”注意就搜这个全称。搜索结果里应该第一个就是。点击它然后点击“安装”Install。安装完成后别忘了回到社区插件列表找到它并点击旁边的“启用”Enable开关。启用后在设置页面左侧就会出现一个“Obsidian Git”的选项。点进去我们需要配置几个关键项Vault backup interval (minutes)自动备份间隔分钟。我一般设置为 30 或 60。这意味着插件会每隔你设定的时间自动执行一次git add .,git commit -m “Auto backup by Obsidian Git”,git push的操作。这简直是“懒人福音”你完全不用操心备份的事。Auto pull on startup启动时自动拉取。建议开启。这样每次打开 Obsidian它会自动从云端拉取一次最新更改确保你电脑上的版本是最新的。Auto push after commit提交后自动推送。建议开启。当你手动点击插件的提交按钮后它会自动推送到云端。Commit message可以自定义自动提交时生成的消息。配置好后你可以在 Obsidian 的左侧边栏或命令面板Ctrl/CmdP里找到 Obsidian Git 插件提供的按钮进行手动提交、推送、拉取等操作非常方便。至此Windows 端的“控制中心”就搭建完毕了它已经可以自动或手动地将你的笔记变更同步到云端 GitHub 仓库。4. iOS 端配置精讲用 Working Copy 打通最后一公里电脑端配置好了笔记已经安全地躺在了 GitHub 上。现在我们要在 iPhone 上建立一个“前线哨所”能够随时从云端获取最新情报笔记并且也能将前线收集的情报手机上的修改送回去。这个任务就交给Working Copy这个强大的 App。4.1 克隆仓库到本地文件系统首先打开 iPhone 上的 Working Copy。第一次使用它会请求访问本地文件的权限务必允许。进入应用后点击右上角那个带着加号的“文档”图标注意不是单纯的加号是有一个文档轮廓的加号。在弹出的菜单中选择 “Clone Repository”。接下来我们需要告诉 Working Copy 去克隆哪个仓库。最省事的方法是点击 “Sign In with GitHub”或 Gitee授权 Working Copy 访问你的账户。授权成功后你就能在列表里直接看到你所有的仓库找到我们刚刚创建的my-obsidian-vault点击它。点击后你会进入仓库的详情页这里直接点击下方的 “Clone” 按钮即可。Working Copy 会开始将云端仓库的所有内容下载到手机本地。你也可以选择手动输入信息在 Clone 页面选择 HTTPS然后在 “URL” 一栏直接粘贴完整的仓库 HTTPS 链接Working Copy 会自动解析出主机、路径等信息。克隆完成后这个仓库就会出现在 Working Copy 的主页列表中。长按这个仓库的图标会弹出菜单我们选择 “Share” - “Save to Files”保存到文件。这时会跳转到 iOS 系统的“文件”应用。我们需要选择一个保存位置。关键来了请导航到“我的 iPhone” - “Obsidian” 文件夹下。如果 Obsidian 文件夹不存在你可以点击“文件”应用左上角的“浏览”在“我的 iPhone”下点击“新建文件夹”创建一个名为 “Obsidian” 的文件夹。然后选择这个 “Obsidian” 文件夹点击右上角的“保存”。这个操作的本质是将 Working Copy 管理下的 Git 仓库文件复制一份到 iOS 的文件系统中一个 Obsidian 能够访问到的位置。Working Copy 本身是一个 Git 管理器而 Obsidian 需要直接读取纯文件。4.2 在 Obsidian 中打开并连接仓库现在打开 iPhone 上的 Obsidian App。如果你是第一次使用它会提示你“打开已有仓库”或“创建新仓库”。我们点击“打开”然后从位置列表中选择“本地文件夹”或“On My iPhone”。接着导航到你刚才保存的路径“我的 iPhone” - “Obsidian” -my-obsidian-vault文件夹。点击它Obsidian 就会加载这个笔记库。稍等片刻你电脑上所有的笔记、文件夹结构、甚至你安装的插件和主题如果它们也被同步了都会完美地呈现在你的手机 Obsidian 里第一次打开可能会提示你“这是一个新仓库是否信任其中的插件”选择信任即可。现在你的手机和电脑已经共享同一个知识库了。你在电脑上写的笔记手机上立刻就能看到。4.3 理解 iOS 端的同步逻辑拉取与推送配置虽然完成了但 iOS 端的同步逻辑和电脑端有些不同理解这一点才能高效使用。在 Working Copy 中你仓库的详情页顶部通常会有一个“Pull”按钮。这个“Pull”按钮就是 iOS 端同步的核心。它的作用是从云端 GitHub 仓库拉取最新的更改即你在电脑上更新并推送的内容到你的手机本地。所以当你想要获取电脑上最新的笔记时就打开 Working Copy找到对应的仓库点击一下“Pull”。拉取完成后你再打开手机 Obsidian内容就已经更新了。那么在手机上修改了笔记如何同步回电脑呢这里就涉及到 Working Copy 免费版和付费版的区别。免费版的 Working Copy 可以完美执行“拉取”Pull操作但“提交”Commit和“推送”Push功能是锁定的。这意味着你可以在手机上用 Obsidian 修改笔记但无法通过 Working Copy 将这些修改打包成一个新版本并推送到云端。如何解决手机修改的同步问题我有两个实践下来的策略以电脑端为“主写入端”手机端以“查阅和轻量修改”为主这是最省心的模式。大部分深度写作、整理工作在电脑上完成利用 Obsidian Git 插件自动同步到云端。手机主要用于外出时查阅、阅读或者记录一些零碎的想法即使记录了也先保存在手机本地。等回到电脑前在电脑上做一个统一的整理和提交。这个策略适合同步需求不那么即时且手机编辑频率不高的用户。利用 Working Copy 的有限免费操作完成推送实际上Working Copy 的免费版并非完全不能提交。你可以通过它的“Web Editor”功能编辑单个文件并提交或者通过“共享”功能将其他 App 的内容保存到仓库并提交。但这比较繁琐不适合频繁操作。如果你真的需要在手机上高频次、完整地进行 Git 操作包括 Commit 和 Push那么购买 Working Copy 的专业版授权是一个值得考虑的选择它是一次性买断的。我个人的习惯是采用第一种策略。手机对我来说更像一个“阅读器”和“灵感速记本”深度加工永远在电脑大屏幕上进行。这样既避免了复杂的配置也让工作流更有条理。5. 高级技巧与避坑指南基础流程走通后你可能还想让这套系统更顺手或者遇到了一些小问题。这里分享几个我实战中总结的高级技巧和常见坑点。技巧一优化 .gitignore 文件让同步更干净你的 Obsidian 笔记库里可能有一些文件是不需要同步的比如缓存文件、临时文件、某些插件生成的数据等。同步它们只会浪费空间和流量。我们可以在仓库根目录创建一个名为.gitignore的文本文件注意前面有个点在里面告诉 Git 忽略哪些文件。一个基础的 Obsidian.gitignore内容可以参考# Obsidian 缓存和临时文件 .obsidian/cache/ .obsidian/workspace .trash/ # 系统文件 .DS_Store Thumbs.db # 可选如果你不想同步插件配置因为不同设备插件配置可能不同可以忽略整个 .obsidian 文件夹 # .obsidian/创建并保存这个文件后记得也要执行git add .gitignore和git commit -m Add .gitignore来把它纳入版本管理。技巧二处理合并冲突Conflict这是使用 Git 同步无法完全避免的问题。冲突通常发生在你同时在电脑和手机上修改了同一文件的同一行然后先后推送时。Git 无法自动决定该保留哪个版本。当冲突发生时Obsidian Git 插件或 Working Copy 会提示你。解决冲突需要手动处理冲突文件文件里会有类似 HEAD你的更改和别人的更改这样的标记。你需要打开文件仔细判断保留正确的部分删除这些标记和不需要的代码然后重新提交。对于笔记来说冲突概率不高但了解这个机制很重要。技巧三使用 Gitee 替代 GitHub 获得更佳速度对于国内用户访问 GitHub 有时可能速度较慢。你可以完全使用Gitee码云来替代整个过程一模一样。只需要在创建仓库、添加远程地址等步骤中把github.com替换为gitee.com即可。Gitee 的免费套餐也足够个人笔记同步使用。常见坑点回顾分支名不对推送时总失败检查一下你的默认分支到底是master还是main。iOS 端 Obsidian 找不到仓库确保在 Working Copy 的“保存到文件”步骤中准确地将仓库保存到了“我的 iPhone”下的“Obsidian”文件夹内并且在 Obsidian App 中是从“本地文件夹”去打开这个路径。HTTPS 认证失败GitHub 现已禁用密码认证需要使用 Personal Access Token。在 GitHub 设置中生成一个 Token在命令行要求输入密码时就粘贴这个 Token。自动备份不工作检查 Obsidian Git 插件的设置确保备份间隔不是 0并且插件已启用。有时电脑休眠可能会影响定时任务。这套基于 Git 的 Obsidian 跨平台同步方案我已经稳定使用了超过一年。它最大的优点就是可控、可靠、零成本。所有数据都在你自己掌控的仓库里版本历史清晰可查再也不用担心云服务商倒闭或者突然收费。虽然初期配置需要一点学习成本但一旦搭建完成它就像房子的地基一样稳固可靠让你可以完全专注于在 Obsidian 这个强大的工具中进行思考和创作享受在 Windows 和 iOS 设备间无缝切换、思想自由流动的畅快感。