家里用的 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 是最省事的方案。配置流程非常简单在 Obsidian 左侧边栏打开“设置”Settings。找到“同步”Sync选项点击“设置同步”Set up Obsidian Sync。登录账号选择“创建新同步库”或“连接到已有同步库”。如果已有笔记库直接在当前库开启同步它会把这个本地文件夹里的内容推送到官方服务器。官方 Sync 的一个关键特性是端到端加密。在开启同步时它会提示你设置一个加密密码这个密码不会上传到官方服务器官方也没法帮你找回。换句话说如果你把密码忘了你的笔记数据在服务器上就是一堆无法解密的乱码连官方都救不了你。这一点既是它隐私性强的体现也是容易踩坑的地方密码一定要单独存好。实际体验上官方 Sync 的增量同步做得不错双链、附件、插件配置都能完整同步而且有版本历史误删了文件可以在网页端或者客户端里找回。它的缺点就是收费价格不算便宜而且服务端在海外如果你在公司或家里的网络访问海外服务不够稳定同步速度会有明显波动。所以它适合预算充足、不想折腾、对数据隐私要求高同时网络环境相对通畅的用户。2.2 Syncthing 免费点对点我的主力方案Syncthing 是我目前的主力方案免费、开源、点对点数据不经过任何第三方服务器。它的核心逻辑是两台设备都安装 Syncthing 客户端互相添加对方的设备 ID然后指定同一个文件夹做双向同步。只要两台设备同时在线就会自动同步如果不在同一局域网也能通过中继机制穿透过去数据在传输过程中是加密的。Windows 端配置步骤去 Syncthing 官网下载 Windows 版解压后运行syncthing.exe。浏览器会自动打开管理界面地址一般是localhost:8384。点击“添加文件夹”Add Folder填写文件夹 ID建议用英文比如obsidian-vault、文件夹路径指向你的 Obsidian 库目录、文件夹类型选择“发送和接收”Send Receive。Mac 端配置步骤我推荐用 Homebrew 安装终端执行brew install syncthing然后用brew services start syncthing让它常驻后台。也可以用图形版 Syncthing.app但底层逻辑一样。打开管理界面重复上面的添加文件夹操作注意文件夹 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 上。这套方案不受电脑是否开机限制只要坚果云服务器在线就能作为中转站。配置步骤注册一个坚果云账号在网页端“账户信息”→“安全选项”里添加一个应用密码。这里要用“应用密码”不能用登录密码因为第三方应用走的是 WebDAV 协议应用密码更安全。在 Obsidian 里安装 Remotely Save 插件。社区插件市场直接搜 Remotely Save安装后启用。插件设置里远程服务选择“WebDAV”填上坚果云给你的服务器地址、账号和刚才生成的应用密码。在坚果云里创建一个目录比如/Obsidian把插件里的远程根路径也设置成它。设置同步方式可以选定时自动同步比如每 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-真的不能再改.mdWindows 端同步时可能直接报错或无法访问。我吃过这个亏后来养成了文件名尽量不超过 30 到 40 个字符、目录层级不超过三层的习惯。大小写敏感也是一个隐患。macOS 的 APFS 默认大小写不敏感但保留大小写Windows 也是大小写不敏感的文件系统。但在 Obsidian 内部[[链接]]是对大小写敏感的如果你的笔记里写了[[Mac使用技巧]]实际文件名却是mac使用技巧.mdmacOS 上打开可能没问题Windows 上就会变成红色断链。所以建笔记时务必统一大小写风格不要今天建一个ChatGPT明天又建一个chatgpt。换行符问题主要出现在 Git 同步或跨编辑器编辑时。Windows 习惯用 CRLFmacOS 用 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 时的状态标签页全是家里正开的笔记完全乱套。所以这个文件必须放进忽略规则。我把实践经验整理成一个表你配置忽略规则时可以照着做内容是否同步原因笔记.md文件必须同步核心数据附件图片、PDF必须同步笔记引用的资源.obsidian/plugins/建议同步保证插件一致.obsidian/themes/建议同步保证主题一致.obsidian/workspace.json不要同步标签页布局会互相覆盖.DS_Store、Thumbs.db不要同步系统垃圾文件插件生成的缓存/索引目录视情况忽略大且无必要3.4 移动端能顺便用上吗虽然标题是 Mac 和 Windows但实际使用中很多人顺手也想在手机或平板上看一眼笔记。不同方案的移动端表现差别很大。用官方 Obsidian SynciOS 和 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 后实时计算渲染出来的所以不用特别同步。想让关系图谱更清晰我分享一个我自己的做法建一个“索引笔记”也叫 MOCMap of Content。比如我建了一个[[工作项目索引]]里面用标题和双链把所有相关笔记串起来然后在每篇子笔记里回链到索引。这样图谱会自动形成以索引为核心的星型结构在 Mac 和 Windows 上看到的图谱形态完全一致不会因为同步问题产生差异。5. 写在最后我的双平台使用心得折腾完这一圈我自己目前的主力配置是Syncthing 做日常实时同步官方 Obsidian Sync 不再续费但我会额外用 Git 做每周快照把整个库推到一个私有仓库里作为最后的兜底。这样即使某天同步出问题也有一个带历史版本的外部备份不至于一年笔记一夜蒸发。如果你问我到底选哪套我给的建议很直接完全不想折腾、愿意花钱、对数据安全有要求直接上官方 Obsidian Sync省下的时间远比订阅费值钱。公司网络访问海外服务不稳定、又不愿付费的优先考虑坚果云 WebDAV 加 Remotely Save。两台电脑都长期开机、喜欢数据完全私有的Syncthing 是我实测后最满意的一套。先别想着把所有功能一次配齐从最简单的方案开始用一段时间再慢慢优化同步这件事本质上没有银弹只有最适合你当前环境的选择。最后再分享一个小技巧无论用哪套方案请务必给笔记库保留一个独立的离线备份通道。Obsidian 的数据是纯文本这意味着你哪怕三个月不打开它只要文件夹还在知识就还在。同步是工具备份才是底线。
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 是最省事的方案。配置流程非常简单在 Obsidian 左侧边栏打开“设置”Settings。找到“同步”Sync选项点击“设置同步”Set up Obsidian Sync。登录账号选择“创建新同步库”或“连接到已有同步库”。如果已有笔记库直接在当前库开启同步它会把这个本地文件夹里的内容推送到官方服务器。官方 Sync 的一个关键特性是端到端加密。在开启同步时它会提示你设置一个加密密码这个密码不会上传到官方服务器官方也没法帮你找回。换句话说如果你把密码忘了你的笔记数据在服务器上就是一堆无法解密的乱码连官方都救不了你。这一点既是它隐私性强的体现也是容易踩坑的地方密码一定要单独存好。实际体验上官方 Sync 的增量同步做得不错双链、附件、插件配置都能完整同步而且有版本历史误删了文件可以在网页端或者客户端里找回。它的缺点就是收费价格不算便宜而且服务端在海外如果你在公司或家里的网络访问海外服务不够稳定同步速度会有明显波动。所以它适合预算充足、不想折腾、对数据隐私要求高同时网络环境相对通畅的用户。2.2 Syncthing 免费点对点我的主力方案Syncthing 是我目前的主力方案免费、开源、点对点数据不经过任何第三方服务器。它的核心逻辑是两台设备都安装 Syncthing 客户端互相添加对方的设备 ID然后指定同一个文件夹做双向同步。只要两台设备同时在线就会自动同步如果不在同一局域网也能通过中继机制穿透过去数据在传输过程中是加密的。Windows 端配置步骤去 Syncthing 官网下载 Windows 版解压后运行syncthing.exe。浏览器会自动打开管理界面地址一般是localhost:8384。点击“添加文件夹”Add Folder填写文件夹 ID建议用英文比如obsidian-vault、文件夹路径指向你的 Obsidian 库目录、文件夹类型选择“发送和接收”Send Receive。Mac 端配置步骤我推荐用 Homebrew 安装终端执行brew install syncthing然后用brew services start syncthing让它常驻后台。也可以用图形版 Syncthing.app但底层逻辑一样。打开管理界面重复上面的添加文件夹操作注意文件夹 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 上。这套方案不受电脑是否开机限制只要坚果云服务器在线就能作为中转站。配置步骤注册一个坚果云账号在网页端“账户信息”→“安全选项”里添加一个应用密码。这里要用“应用密码”不能用登录密码因为第三方应用走的是 WebDAV 协议应用密码更安全。在 Obsidian 里安装 Remotely Save 插件。社区插件市场直接搜 Remotely Save安装后启用。插件设置里远程服务选择“WebDAV”填上坚果云给你的服务器地址、账号和刚才生成的应用密码。在坚果云里创建一个目录比如/Obsidian把插件里的远程根路径也设置成它。设置同步方式可以选定时自动同步比如每 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-真的不能再改.mdWindows 端同步时可能直接报错或无法访问。我吃过这个亏后来养成了文件名尽量不超过 30 到 40 个字符、目录层级不超过三层的习惯。大小写敏感也是一个隐患。macOS 的 APFS 默认大小写不敏感但保留大小写Windows 也是大小写不敏感的文件系统。但在 Obsidian 内部[[链接]]是对大小写敏感的如果你的笔记里写了[[Mac使用技巧]]实际文件名却是mac使用技巧.mdmacOS 上打开可能没问题Windows 上就会变成红色断链。所以建笔记时务必统一大小写风格不要今天建一个ChatGPT明天又建一个chatgpt。换行符问题主要出现在 Git 同步或跨编辑器编辑时。Windows 习惯用 CRLFmacOS 用 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 时的状态标签页全是家里正开的笔记完全乱套。所以这个文件必须放进忽略规则。我把实践经验整理成一个表你配置忽略规则时可以照着做内容是否同步原因笔记.md文件必须同步核心数据附件图片、PDF必须同步笔记引用的资源.obsidian/plugins/建议同步保证插件一致.obsidian/themes/建议同步保证主题一致.obsidian/workspace.json不要同步标签页布局会互相覆盖.DS_Store、Thumbs.db不要同步系统垃圾文件插件生成的缓存/索引目录视情况忽略大且无必要3.4 移动端能顺便用上吗虽然标题是 Mac 和 Windows但实际使用中很多人顺手也想在手机或平板上看一眼笔记。不同方案的移动端表现差别很大。用官方 Obsidian SynciOS 和 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 后实时计算渲染出来的所以不用特别同步。想让关系图谱更清晰我分享一个我自己的做法建一个“索引笔记”也叫 MOCMap of Content。比如我建了一个[[工作项目索引]]里面用标题和双链把所有相关笔记串起来然后在每篇子笔记里回链到索引。这样图谱会自动形成以索引为核心的星型结构在 Mac 和 Windows 上看到的图谱形态完全一致不会因为同步问题产生差异。5. 写在最后我的双平台使用心得折腾完这一圈我自己目前的主力配置是Syncthing 做日常实时同步官方 Obsidian Sync 不再续费但我会额外用 Git 做每周快照把整个库推到一个私有仓库里作为最后的兜底。这样即使某天同步出问题也有一个带历史版本的外部备份不至于一年笔记一夜蒸发。如果你问我到底选哪套我给的建议很直接完全不想折腾、愿意花钱、对数据安全有要求直接上官方 Obsidian Sync省下的时间远比订阅费值钱。公司网络访问海外服务不稳定、又不愿付费的优先考虑坚果云 WebDAV 加 Remotely Save。两台电脑都长期开机、喜欢数据完全私有的Syncthing 是我实测后最满意的一套。先别想着把所有功能一次配齐从最简单的方案开始用一段时间再慢慢优化同步这件事本质上没有银弹只有最适合你当前环境的选择。最后再分享一个小技巧无论用哪套方案请务必给笔记库保留一个独立的离线备份通道。Obsidian 的数据是纯文本这意味着你哪怕三个月不打开它只要文件夹还在知识就还在。同步是工具备份才是底线。