这篇不讲原理、不做横评，就干一件事：带你从零开始，把 Obsidian 手机和电脑之间的同步一步一步配好。全程跟着做，10 分钟内可以搞定，配置完成后笔记会自动在设备之间流转，不用再靠微信传文件或者复制粘贴。
Obsidian 本身是一个纯本地的 Markdown 笔记工具，官方提供的付费同步服务对不少用户来说成本偏高，而社区插件生态里已经有成熟的替代方案。目前对中文用户最省心的路线，就是用坚果云官方适配 Obsidian 的 Nutstore Sync 插件：注册一个坚果云账号，装上插件，OAuth 授权登录，剩下的交给自动同步。下面按步骤来。
第一步：注册坚果云账号
先去坚果云官网，用邮箱或手机号注册一个账号。
插件是通过坚果云账号登录的，安装插件前记得先注册一个坚果云账号。 没有账号的话，后面的授权登录环节走不下去。
注册免费版就够了。个人免费版提供的上传下载流量对纯文字笔记的同步场景来说完全够用——Markdown 文件本身很小，日常增删改几十篇笔记，消耗的流量基本可以忽略不计。如果笔记库里塞了大量图片、PDF 附件且更新频繁，可以再考虑升级，但先别急着花钱，跑一段时间看看实际用量再说。
第二步：电脑端安装插件
打开电脑端的 Obsidian，按这个路径操作：
- 点左下角齿轮图标，进入 设置；
- 在左侧列表找到 第三方插件（社区插件）；
- 先 关闭安全模式（Obsidian 默认禁用第三方插件，这是正常的，关掉才能安装社区插件）；
- 点 浏览社区插件，在搜索框输入 Nutstore Sync；
- 找到插件后点 安装，然后点 启用。
启用后，左侧边栏或功能区会出现坚果云插件的入口，说明装好了。
第三步：电脑端登录
点击插件面板上的 登录 按钮，浏览器会自动弹出坚果云的授权页面，确认授权后页面会自动跳回 Obsidian，登录完成。
这里多说一句原理：插件用的是 OAuth 单点登录机制，也就是你只需要在浏览器里确认一次”允许插件访问我的坚果云”，凭证会自动保存在 Obsidian 里。整个过程中你不需要手动填 WebDAV 地址、端口，也不需要在应用密码里单独生成密码——这些早期教程里让你折腾的东西，现在插件都自动处理了。如果你在网上看到 older 教程让你去坚果云网页版开”第三方应用管理”拿 WebDAV 信息，那是给不支持 OAuth 的老方案用的，Nutstore Sync 插件不用这么麻烦。
第四步：首次同步
登录成功后就可以发起首次同步了。首次同步前，有两个建议认真看一下：
一是开启宽松模式。 宽松模式下，插件对同步请求的节奏会更从容，避免短时间内打出大量请求。
二是先把笔记库完整复制到目标设备，再开启同步。 插件对”同名且同大小”的文件会直接跳过，不重复上传下载。为什么要这么做？因为如果你的笔记库有几千个文件，首次同步时所有文件都处于”待变更”状态，同时变更的文件太多容易触发云端的请求频率限制。先把库复制过去，让大部分文件”对齐”，再开同步，实际需要传输的就只有差异部分，又快又稳。
如果操作过程中碰到 “请求频繁” 的报错，不用慌，这通常是短时间内同步请求过于密集触发的保护机制：先歇半小时再重试，同时确认宽松模式已开启。
第五步：手机端安装配置
电脑端就绪后，轮到手机：
- 手机上打开 Obsidian，同样进入设置 → 第三方插件，关闭安全模式；
- 浏览社区插件，搜索 Nutstore Sync，安装并启用；
- 点击登录，用 同一个坚果云账号 授权；
- 登录后，在插件设置里找到 远程目录 选择项（这个选项 PC 端和移动端都有），选择你电脑端已经同步好的笔记库文件夹；
- 点同步，等待手机端把库拉取完整。
配置完成后，你在电脑上改一篇笔记，几十秒内手机端就能看到最新版本，反过来也一样（取决于第六步选的同步策略）。
第六步：设置同步策略
这是很多人忽略、但其实最能决定使用体验的一步。插件提供 5 种同步策略，完整列出如下：
- 双向同步：本地和云端互相覆盖，保持一致；
- 仅发送：只把本地变更推送到云端，不拉取云端变更；
- 仅接收：只从云端拉取变更，本地改动不上传；
- 仅接收并还原本地变更：拉取云端的同时，把本地多出来的改动还原掉；
- 仅发送并覆盖云端变更：推送本地版本，并覆盖云端上的其他变更。
怎么选？给你一个实战建议：
- 主力电脑：选 双向同步。这是你的笔记生产主阵地，需要完整的读写闭环；
- 手机只是查看：选 仅接收。如果你在手机上基本只读不写，这个策略能从根本上避免手机上的误操作、误编辑把主库搞乱；
- 出差用的笔记本：选 仅发送，当作单向备份出口用。
策略不是一成不变的，设备角色变了随时改。
第七步：设置冲突解决
两台设备同时改了同一篇笔记，怎么办？这就是冲突解决策略要处理的问题。插件提供 4 种冲突策略：
- 无冲突合并：自动合并不冲突的部分；
- Diff3 合并：生成 Git 风格的冲突标记，并配合 AI 辅助解决冲突；
- 本地优先：冲突时保留本地版本；
- 服务器优先：冲突时用云端版本覆盖本地。
推荐主力设备用 Diff3 合并。 理由是它不会悄悄丢内容：有分歧的段落会以清晰的冲突标记呈现出来，你看得见两边的改动分别是什么，还能借助 AI 辅助来处理冲突，由你来裁决而不是让同步引擎替你做决定。”本地优先”和”服务器优先”更省事，但牺牲的是其中一方的改动，日记、周报这类重要内容慎用。
第八步（可选）：同步 .obsidian 配置目录
笔记内容同步好之后，你可能还想要主题、快捷键、插件列表这些配置也跨设备一致。插件支持同步 .obsidian 配置目录，但这不是默认开启的，需要在插件设置中手动选择，档位有三档：
- 不同步：默认状态，配置只在本地生效；
- 仅同步书签：只同步书签数据，风险最低；
- 同步全部（实验性）：主题、快捷键、插件设置整套同步，官方标注为实验性功能。
如果你希望电脑和手机的 Obsidian 界面、快捷键保持一致，选”同步全部”。但要提醒两点：一是工作区状态和各类缓存文件建议谨慎处理，不同设备屏幕尺寸不同，工作区布局强行同步反而容易出问题；二是动手前先把笔记库做一次备份，配置同步出问题时不至于伤及笔记本体。
验证清单
配置完成后，别急着走，按这份清单逐条验证一遍：
- 电脑上改一篇笔记，几分钟后手机端打开，内容是最新的吗？
- 手机上新建一篇笔记，电脑端能同步到吗？
- 在电脑上删掉一篇笔记，能去坚果云的回收站把它找回来吗？
- 故意在两台设备上改同一篇笔记，冲突标记清晰吗？能看懂两边各改了什么吗？
- AI 助手能用吗？（API Key 保存在本地，调用走你自己配置的模型平台，确认配置正确即可）
- 在坚果云网页版里能看到文件的历史版本吗？能回滚到昨天的状态吗？
- 飞行模式下改笔记，恢复网络后会自动补同步吗？
- 手机端打开大一点的笔记库，索引和同步过程有没有反复报错？
七条以上通过，你的同步环境就算稳了。
常见问题排查
- 手机端加载失败 / 一直转圈：先重装插件试试，还不行就换一个网络环境（比如从 WiFi 切到流量），部分网络对云盘连接不友好；
- 提示”请求频繁”：歇半小时再重试，同时确认宽松模式已开启，并检查是否有过多设备或过短的自动同步间隔在同时跑；
- 同步很慢：检查是否是增量同步在生效——只传改动部分才是正常状态，如果每次都在全量比对，重新检查插件设置；
- .obsidian 配置同步出问题：先把配置同步档位切回”不同步”，让笔记内容恢复正常，再逐项排查（先试”仅同步书签”，最后才考虑”同步全部”）。
FAQ
Q1：坚果云免费额度够用吗？
纯 Markdown 文字笔记完全够用。Markdown 文件体积很小，日常写作、修改产生的流量很低。如果你的库里塞满大体积附件且频繁改动，才需要考虑付费版或把附件单独管理。
Q2：iOS 和 Android 都支持吗？
都支持。Nutstore Sync 插件本身基于 Obsidian 的跨平台插件框架，手机端（iOS/Android）和电脑端（Windows/macOS/Linux）安装配置流程一致，用同一个账号登录即可。
Q3：同步会耗很多流量吗？
不会。插件走的是增量同步逻辑，只传输有改动的部分。一篇笔记改了几个字，实际传输的就是这点差异，日常使用一个月的同步流量通常远小于你刷十分钟短视频。
Q4：电脑端用坚果云客户端还是只用插件？
三种组合各有适用面，摊开说，不做结论性推荐：
- 只用插件：最轻量，登录、同步、策略管理都在 Obsidian 里完成，适合只想解决笔记同步的人；
- 只用坚果云客户端：把整个笔记库文件夹放进坚果云同步目录，靠文件级同步工作，但不会帮你处理 Markdown 冲突合并， Obsidian 索引缓存目录还可能产生大量同步噪音；
- 插件 + 客户端共存：插件负责笔记内容，客户端顺带同步其他工作文件，但要注意两者同时跑同一目录时可能互相触发变更。
Q5：遇到冲突会丢内容吗？
选对策略就不会。Diff3 合并会把冲突以标记形式完整保留两边的改动，配合 AI 辅助解决，内容不凭空消失。真正的丢内容风险来自”服务器优先/本地优先”这类覆盖型策略，重要库别用。
Q6：AI 助手怎么配置 API Key？
在插件的 AI 辅助设置里填入你自己申请的模型平台 API Key。Key 保存在本地设备上，不会上传到坚果云，实际调用也是你的设备直接请求你配置的模型平台，坚果云侧不参与密钥托管。
Q7：换了手机怎么迁移？
新手机装 Obsidian，安装 Nutstore Sync 插件，用同一个坚果云账号登录，远程目录选择原笔记库文件夹，发起同步等待拉取完整即可。旧手机确认同步完成后再退出登录或卸载，避免残留的本地状态产生多余变更。
写在最后
把 Obsidian 的同步配好，本质上是给自己的数字资产修一条可靠的传送带。配完之后你获得的不只是”手机电脑能看到同一份笔记”，还有坚果云侧的回收站找回、历史版本回滚这些保底能力——手滑删库、误改覆盖，都还有后悔药可吃。
个人免费版足够先把整套流程跑通。如果你的需求是团队协作——比如部门知识库、多人共享笔记目录、精细的成员权限管理——可以直接试坚果云团队版（含 20 天免费试用），零成本把整套同步和权限体系验证一遍再决定。