Obsidian跨平台同步实战：Mac与Windows三套方案对比与踩坑记录

家里用的 MacBook，公司发的 Windows 台式机，每天要在两套系统之间切换，这种工作流下 Obsidian 的同步问题迟早会找上门。Obsidian 和很多在线笔记工具不一样，它没有一个“默认云端服务器”的概念，所有笔记本质上是躺在本地的 Markdown 文件夹，所以同步这件事并不是软件自带的功能，而是你自己要解决的跨平台数据管理题。

这篇文章把我自己实测过的三套方案完整记录下来：官方 Obsidian Sync、Syncthing 免费点对点同步、坚果云 WebDAV 配合 Remotely Save 插件。每条方案都包含配置步骤、使用感受和踩坑记录。如果你也正在为 Mac 和 Windows 之间的 Obsidian 库同步发愁，直接照着选一套就行。我尽量把话说得实在一点，不搞虚的。

1. 方案选型先想清楚：Obsidian 到底在同步什么

1.1 本地库不是云笔记，同步的本质是“文件夹对文件夹”

Obsidian 的核心设计是本地优先，一个笔记库（Vault）就是一个普通文件夹，里面是你自己的.md文件、图片附件、PDF，以及一个叫.obsidian的隐藏配置目录。每次打开 Obsidian，它做的事情本质上就是“读取这个文件夹并渲染成图形界面”。

所以跨平台同步，说白了就是让公司 Windows 上的这个文件夹，和家里 Mac 上的这个文件夹，尽可能保持状态一致。这跟你同步一个放满文档的工作目录没有本质区别，只是 Obsidian 用了大量小文件、且边写边自动保存，对同步的实时性和稳定性要求更高。

很多人一开始会走弯路，把 Obsidian 笔记放进微信文件传输助手、U 盘、邮件附件里，结果就是今天改的文件明天忘了拷，版本满天飞。这不是 Obsidian 的问题，而是没有建立一个“文件夹自动保持双向一致”的通道。后面讲的三套方案，本质上都是在做这件事。

1.2 同步方案的五个判断维度

我在选型前给自己列了几个硬指标，你也可以照着核对：

• 实时性：我在公司电脑写完一行字，回到家打开 Mac，能不能立刻看到最新内容？还是要手动同步/等待几分钟？
• 价格和隐私：方案是否免费？数据是否经过第三方服务器，还是点对点加密？
• 网络环境适配：公司网络是否有外网限制？家里和公司不在一起，能否穿透不同网络？
• 冲突处理能力：两台电脑同时改了同一个文件，最后是生成冲突副本，还是静默覆盖？
• 移动端扩展性：以后如果用手机/平板看笔记，这套方案还能不能继续用？

用这几个维度去筛，常见的候选方案其实很快就淘汰了。iCloud 虽然 Mac 端好用，但 Windows 客户端体验一言难尽，经常出现文件只占位不同步的情况；OneDrive 在公司 Windows 上没毛病，但 Mac 端对 Obsidian 这类海量小文件的同步表现也容易出幺蛾子；U 盘这种手工方案就不提了，完全是靠纪律在维持。

1.3 为什么我把选择范围缩小到“免费 + 双向 + 准实时”

我自己是很典型的双平台场景：公司电脑是 Windows，家里是 Mac，两边都不是固定 IP，也没有公网服务器，NAS 目前还没买。最早我想过用 Git 同步，但 Obsidian 的笔记是边写边存，每次都要手动 commit、push、pull，写笔记的流畅感会被打断。后来也试过直接用坚果云客户端同步整个文件夹，但坚果云客户端对大量小文件的实时性一般，而且会占用本地磁盘空间做缓存。

最终留下来持续在用的，就是我后面要展开的三套：官方 Obsidian Sync、Syncthing、坚果云 WebDAV 加 Remotely Save 插件。它们各有各的适用场景，没有绝对的好坏，只看你的预算、网络环境和动手能力。下面我按“花钱省心”到“免费折腾”的顺序来讲。

2. 三套实测可用的跨平台同步方案

2.1 官方 Obsidian Sync：花钱买省心，端到端加密

如果不想折腾，官方 Obsidian Sync 是最省事的方案。配置流程非常简单：

1. 在 Obsidian 左侧边栏打开“设置”（Settings）。
2. 找到“同步”（Sync）选项，点击“设置同步”（Set up Obsidian Sync）。
3. 登录账号，选择“创建新同步库”或“连接到已有同步库”。
4. 如果已有笔记库，直接在当前库开启同步，它会把这个本地文件夹里的内容推送到官方服务器。

官方 Sync 的一个关键特性是端到端加密。在开启同步时，它会提示你设置一个加密密码，这个密码不会上传到官方服务器，官方也没法帮你找回。换句话说，如果你把密码忘了，你的笔记数据在服务器上就是一堆无法解密的乱码，连官方都救不了你。这一点既是它隐私性强的体现，也是容易踩坑的地方，密码一定要单独存好。

实际体验上，官方 Sync 的增量同步做得不错，双链、附件、插件配置都能完整同步，而且有版本历史，误删了文件可以在网页端或者客户端里找回。它的缺点就是收费，价格不算便宜，而且服务端在海外，如果你在公司或家里的网络访问海外服务不够稳定，同步速度会有明显波动。所以它适合预算充足、不想折腾、对数据隐私要求高，同时网络环境相对通畅的用户。

2.2 Syncthing 免费点对点：我的主力方案

Syncthing 是我目前的主力方案，免费、开源、点对点，数据不经过任何第三方服务器。它的核心逻辑是：两台设备都安装 Syncthing 客户端，互相添加对方的设备 ID，然后指定同一个文件夹做双向同步。只要两台设备同时在线，就会自动同步；如果不在同一局域网，也能通过中继机制穿透过去，数据在传输过程中是加密的。

Windows 端配置步骤：

1. 去 Syncthing 官网下载 Windows 版，解压后运行syncthing.exe。
2. 浏览器会自动打开管理界面，地址一般是localhost:8384。
3. 点击“添加文件夹”（Add Folder），填写文件夹 ID（建议用英文，比如obsidian-vault）、文件夹路径（指向你的 Obsidian 库目录）、文件夹类型选择“发送和接收”（Send & Receive）。

Mac 端配置步骤：

1. 我推荐用 Homebrew 安装，终端执行brew install syncthing，然后用brew services start syncthing让它常驻后台。
2. 也可以用图形版 Syncthing.app，但底层逻辑一样。
3. 打开管理界面，重复上面的添加文件夹操作，注意文件夹 ID 必须和 Windows 端填成同一个，比如都是obsidian-vault。

接下来是设备配对：在 Windows 端的管理界面里点击“操作”（Actions）→“显示 ID”（Show ID），复制这串设备 ID；到 Mac 端的管理界面，点击“添加远程设备”（Add Remote Device），粘贴这串 ID，反向再操作一次。两台设备都添加对方后，文件夹那边会弹出一条“共享”提示，确认接受后，双向同步就真正建立了。

第一次全量同步会比较慢，特别是笔记库里图片和 PDF 多的时候，耐心等它跑完。之后我实测在公司写完一段笔记，回到家用 Mac 打开，基本上是秒级同步，局域网内更快。

Syncthing 有一个容易被忽略的关键功能：文件版本控制。在文件夹设置里找到“文件版本控制”（File Versioning），选择“简单版本控制”（Simple File Versioning），它会自动把被覆盖或删除的文件保留到.stversions目录里。这样就算某天同步出错把文件改坏了，也能找回旧版本。强烈建议开启，等于给自己加了一道保险。

同时一定要配置忽略规则。我举个例子，Mac 的 Finder 会在文件夹里生成一堆.DS_Store文件，Windows 上完全没用；Obsidian 的.obsidian/workspace.json记录的是当前打开的标签页和窗口布局，两边同步这个文件反而会让标签页互相“打架”。所以在.stignore里加上这些规则：

// .stignore .DS_Store .obsidian/workspace.json .obsidian/workspace-mobile.json

要注意，不要图省事把整个.obsidian目录忽略掉，否则插件和主题不会同步，另一台电脑上的 Obsidian 打开后会是另一个样子。

Syncthing 的缺点也很明显：要折腾。第一次配置 ID、文件夹、忽略规则、版本控制，大约需要二十分钟；而且两台电脑必须同时运行 Syncthing 客户端，如果公司电脑关机了，家里这边就收不到更新。它也不像官方 Sync 那样自带一个网页端可以随时随地看笔记，基本只能靠电脑在线。但换来的是免费、无流量限制、数据完全自己掌控。

2.3 坚果云 WebDAV + Remotely Save：国内网络环境下最稳的选择

第三套方案是两个东西组合起来的：坚果云提供 WebDAV 服务器，Remotely Save 是 Obsidian 的社区插件，负责把整个库定时同步到 WebDAV 上。这套方案不受电脑是否开机限制，只要坚果云服务器在线，就能作为中转站。

配置步骤：

1. 注册一个坚果云账号，在网页端“账户信息”→“安全选项”里添加一个应用密码。这里要用“应用密码”，不能用登录密码，因为第三方应用走的是 WebDAV 协议，应用密码更安全。
2. 在 Obsidian 里安装 Remotely Save 插件。社区插件市场直接搜 Remotely Save，安装后启用。
3. 插件设置里，远程服务选择“WebDAV”，填上坚果云给你的服务器地址、账号和刚才生成的应用密码。
4. 在坚果云里创建一个目录，比如/Obsidian，把插件里的远程根路径也设置成它。
5. 设置同步方式：可以选定时自动同步（比如每 5 分钟），也可以手动点同步按钮。

这套方案的优点是国内访问稳定、免费，手机 App 也能用 Remotely Save 连同一个 WebDAV 地址。缺点是坚果云免费版有流量限制，我记得是每月上传 1GB、下载 3GB 左右，具体以官方政策为准。对纯文本笔记来说完全够用——一篇详细笔记也就几十 KB，一千篇笔记加起来可能才 20MB 到 50MB；但如果你的库里有大量 PDF、视频这类大附件，免费额度很快会被吃掉。

我当时做一个简单的估算：假设笔记附件主要是截图，每张 300KB，每月新增 50 张，那就是 15MB 上传量，加上文本笔记，一个月完全控制在 200MB 以内，流量不是问题。可一旦开始往库里面放产品手册、电子书这类动辄几十 MB 的文件，这个方案就开始吃力了。

顺便说一个 Remotely Save 的坑：它默认会同步整个.obsidian目录，包括插件配置。如果你在公司电脑上装了某些插件，回家后发现插件运行报错，很可能不是因为插件坏了，而是两边系统路径不同导致配置失效。这一点在下一章详细讲。

3. 实操细节与踩坑记录

3.1 冲突文件是怎么产生的，怎么让它少出现

多设备同步一定会遇到冲突。最常见的情况是：你在公司电脑上改了一个笔记，还没等同步完成就合上电脑下班；回家后用 Mac 打开，又改了同一个文件。等两台设备重新建立同步时，发现这个文件在两个地方都被修改过，就产生了“冲突副本”。

不同方案对冲突的处理不一样。官方 Sync 会尽量合并或生成带时间戳的副本；Syncthing 配合版本控制会保留一个冲突副本和旧版本；Remotely Save 经常生成类似标题 (conflicted copy 2025-01-01 123456).md的文件。说实话，看到一屏幕conflicted copy真的很烦。

我后来总结出三个习惯，能大幅减少冲突频率：

• 重要修改前，先确认同步状态。Syncthing 界面变成绿色对勾后再动文件。
• 不要在同一时间点用两台设备编辑同一个笔记。如果只是临时看一眼前一天的记录，尽量只读。
• 如果必须两边交替编辑，中间留出足够的同步完成时间，别改完立刻关机。

还有一点：Obsidian 本身会自动保存，写一行字它就存一下。如果同步软件正好在写入过程中扫描到文件，可能出现文件短暂损坏或同步失败。Syncthing 对这种情况处理得比较好，它会等文件写完再同步；Remotely Save 偶尔会提前抓取不完整文件，遇到这种情况重新打开文件确认一下内容就知道有没有坏。

3.2 macOS 和 Windows 的文件系统差异怎么坑你

很多人在双平台同步后发现链接失效，文件却都在，大概率是踩了这几个差异的坑。

Windows 的路径长度限制是个经典问题。Windows 里文件路径默认不能超过 260 个字符，macOS 则没那么敏感。如果你的文件名起得又长又嵌套了好几层目录，比如工作/项目A/2025年度/市场部/第一季度/XX产品发布会-最终版-FINAL-真的不能再改.md，Windows 端同步时可能直接报错或无法访问。我吃过这个亏，后来养成了文件名尽量不超过 30 到 40 个字符、目录层级不超过三层的习惯。

大小写敏感也是一个隐患。macOS 的 APFS 默认大小写不敏感但保留大小写，Windows 也是大小写不敏感的文件系统。但在 Obsidian 内部，[[链接]]是对大小写敏感的，如果你的笔记里写了[[Mac使用技巧]]，实际文件名却是mac使用技巧.md，macOS 上打开可能没问题，Windows 上就会变成红色断链。所以建笔记时务必统一大小写风格，不要今天建一个ChatGPT，明天又建一个chatgpt。

换行符问题主要出现在 Git 同步或跨编辑器编辑时。Windows 习惯用 CRLF，macOS 用 LF，虽然 Obsidian 本身能兼容显示，但如果后面用 Git 做版本管理，可能会被“整个文件都变了”的假象吓到。用 Obsidian 的话，建议把编辑器设置为统一保存 UTF-8 和 LF，减少这种无意义的差异。

另外记得忽略.DS_Store这类系统垃圾文件。macOS 几乎会在你打开过的每个文件夹里塞一个.DS_Store，如果同步到 Windows 端，纯属浪费时间还占同步记录。

3.3 插件、主题、工作区到底要不要同步

这是最难决策的部分，而且很多人会直接忽略，结果就是插件一边有、一边没有，体验分裂。

我的建议是分两类处理：

第一类，插件本体和主题文件，建议同步。.obsidian/plugins/下面的插件代码，以及.obsidian/themes/下的主题文件，同步过去之后，另一台电脑打开 Obsidian 会自动加载同样的插件和主题，不需要重新下载。这个体验其实挺好的。

第二类，插件配置里的密钥、路径和缓存，要谨慎同步。很多 AI 相关插件，比如社区里常见的 Claudian、Copilot 之类，会把 API Key 存在插件配置里。如果你把整个.obsidian同步到公司电脑，等于把私人密钥直接复制到公司设备上，风险自己掂量一下。还有些插件，比如依赖本机路径的附件管理器，插件配置文件里写的是/Users/你的名字/...这种 mac 绝对路径，到 Windows 上就会失效。

还有一个很多人踩过的坑：.obsidian/workspace.json不能同步。这个文件记录的是“当前打开了哪些标签页、窗口布局是什么样”。如果同步了它，就会出现这种情况：你在公司打开 Obsidian，界面自动变成了昨天晚上在家关闭 Mac 时的状态，标签页全是家里正开的笔记，完全乱套。所以这个文件必须放进忽略规则。

我把实践经验整理成一个表，你配置忽略规则时可以照着做：

3.4 移动端能顺便用上吗

虽然标题是 Mac 和 Windows，但实际使用中，很多人顺手也想在手机或平板上看一眼笔记。不同方案的移动端表现差别很大。

用官方 Obsidian Sync，iOS 和 Android 直接登录同一个账号就能同步，体验最完整，这也是官方方案的一个隐性优势。用 Syncthing 的话，Android 有官方 Syncthing 客户端，效果不错；iOS 因为应用沙盒限制，Syncthing 的体验比较割裂，需要通过“文件 App”或第三方客户端中转，不太推荐普通用户折腾。用 Remotely Save + WebDAV 的话，iOS 和 Android 都可以安装 Obsidian 后配合 Remotely Save 插件，连同一个 WebDAV 地址，体验还算顺畅。

如果你主要场景是 Mac 和 Windows 两台电脑，移动端只是临时翻阅，那不需要为了移动端去选方案。如果移动端是刚需，建议优先考虑官方 Sync，或者 Remotely Save 这种跨端稳定的方案。

4. 常见问题速查与排查技巧

4.1 一觉醒来多了一堆“conflicted copy”文件怎么办

先说怎么避免：去把同步软件的冲突策略设置好。Syncthing 开启文件版本控制，Remotely Save 检查“冲突文件处理方式”。然后，手动把已经产生的冲突文件打开对比，保留正确版本，把多余副本删掉。千万别看着文件名分不清哪个是新的就乱删，先按修改时间排序，再看内容结尾是否有自己想要的新增段落。

以我自己的经验，真正需要人工处理的冲突文件其实很少。大多数冲突，两边内容差别就只有一两句话，手动合并两分钟就搞定。真正恐怖的是你完全放任不管，半年后发现笔记库里有几百个冲突副本，搜笔记时看到满屏重复文件，那才叫灾难。所以建议每两周清理一次同步文件夹里的冲突副本。

4.2 图片附件全是断裂状态，文件明明存在

这种问题通常不是同步问题，而是 Obsidian 引用路径和实际文件名对不上。最典型的就是上一章说的大小写问题，Windows 上链接大小写不一致就会断。还有一种是附件移动过位置，但笔记里的![[附件名]]还是旧路径。

排查方法很简单：在 Obsidian 里点开断裂的链接，选择“重新链接”，或者打开链接面板，看哪些链接失效，逐一修正。平时的好习惯是，往笔记里拖图片后，坚决不手动改附件文件名；如果改了，就用 Obsidian 自带的“管理附件”功能重新整理，别在系统文件管理器里随便移动。

还有一个冷门但常见的原因：同步软件还没把附件传过来，笔记文件已经先到了。比如 Remotely Save 按笔记文件更新时间优先同步，图片才传到一半，你已经在另一台设备上打开了笔记，就会看到一堆临时断图。解决办法是在提醒“同步完成”之前，先不要打开笔记里的图片，或者干脆等图标变成绿色再操作。

4.3 Obsidian 打开库卡顿、索引转个不停

如果你用 Syncthing 或坚果云这类方案，有时候 Obsidian 打开库会明显变卡，右下角一直显示“正在索引”。这通常是因为同步软件正在同步大量文件，Obsidian 检测到文件变化后，会反复重新加载文件列表和链接关系，两边抢资源。

解决办法有几个：一是把同步软件设置成“文件变化后稍等几秒再同步”，而不是实时监控；二是在 Obsidian 设置里关闭自动更新链接，减少文件变动时的计算量；三是避免在一边同步一边开着 Obsidian 写作，尤其是刚全量同步完的头几分钟，先让同步稳定下来。

如果是 Syncthing 用户，还可以检查一下是不是一次性同步了太多无用的缓存文件，比如.obsidian/plugins下面某些插件生成的.cache目录。把这类目录加入忽略规则，索引压力会小很多。

4.4 关系图谱怎么关联：同步之外的进阶玩法

很多刚用 Obsidian 的人会问“关系图谱怎么手动关联”，其实关系图谱根本不需要手动操作。Obsidian 的图谱是自动生成的，它的数据来源是两个东西：笔记之间的[[双链]]，以及#标签。同步只负责把笔记文件传过去，图谱是打开 Obsidian 后实时计算渲染出来的，所以不用特别同步。

想让关系图谱更清晰，我分享一个我自己的做法：建一个“索引笔记”，也叫 MOC（Map of Content）。比如我建了一个[[工作项目索引]]，里面用标题和双链把所有相关笔记串起来，然后在每篇子笔记里回链到索引。这样图谱会自动形成以索引为核心的星型结构，在 Mac 和 Windows 上看到的图谱形态完全一致，不会因为同步问题产生差异。

5. 写在最后：我的双平台使用心得

折腾完这一圈，我自己目前的主力配置是：Syncthing 做日常实时同步，官方 Obsidian Sync 不再续费，但我会额外用 Git 做每周快照，把整个库推到一个私有仓库里，作为最后的兜底。这样即使某天同步出问题，也有一个带历史版本的外部备份，不至于一年笔记一夜蒸发。

如果你问我到底选哪套，我给的建议很直接：完全不想折腾、愿意花钱、对数据安全有要求，直接上官方 Obsidian Sync，省下的时间远比订阅费值钱。公司网络访问海外服务不稳定、又不愿付费的，优先考虑坚果云 WebDAV 加 Remotely Save。两台电脑都长期开机、喜欢数据完全私有的，Syncthing 是我实测后最满意的一套。先别想着把所有功能一次配齐，从最简单的方案开始，用一段时间再慢慢优化，同步这件事本质上没有银弹，只有最适合你当前环境的选择。

最后再分享一个小技巧：无论用哪套方案，请务必给笔记库保留一个独立的离线备份通道。Obsidian 的数据是纯文本，这意味着你哪怕三个月不打开它，只要文件夹还在，知识就还在。同步是工具，备份才是底线。