符号链接本身不跨设备同步，需将目标目录置于iCloud等共享位置，并在每台Mac独立创建指向该路径的软链接；推荐使用~/Library/Mobile Documents/com~apple~CloudDocs/作为可靠iCloud路径。
符号链接本身不能跨设备同步——它只是本地文件系统中的一条“路标”，只在创建它的那台 mac 上有效。真正实现“不同 mac 间同步”的，是把符号链接所指向的**目标文件或目录**放在一个所有设备都能访问、且保持一致的共享位置（比如 icloud、syncthing、nas），再在每台 mac 上各自创建指向该位置的软链接。
核心逻辑：软链接本地化，数据源统一化
软链接不是同步工具，而是路径重定向工具。要让多台 Mac 表现一致，必须做到：
- 所有设备读取同一份真实数据（例如都从 iCloud Drive 的某个固定路径加载）
- 每台 Mac 在自己系统里独立建立软链接，把本地路径（如
~/Library/Application Support/MyApp）指向这个共享路径 - 确保共享路径稳定可写、权限一致、无并发冲突
推荐落地方式：iCloud Drive + 本地软链
iCloud 是 macOS 原生支持最稳的跨设备同步载体，特别适合配置类小文件。关键是要用对路径：
- 目标目录必须建在：
~/Library/Mobile Documents/com~apple~CloudDocs/YourApp/（这是 iCloud Drive 在系统底层唯一可靠挂载点） - 不要用
~/iCloud Drive/这种访达显示路径——它在终端中可能不可靠，且某些应用拒绝写入 - 先在一台 Mac 创建好目录并确认 iCloud 已完成首次上传（访达侧边栏能看见该文件夹）
- 再在每台 Mac 上运行：
ln -sf ~/Library/Mobile\ Documents/com~apple~CloudDocs/YourApp/config ~/Library/Application\ Support/YourApp
替代方案：Syncthing / NAS + 统一路径映射
如果你更看重可控性、隐私或大文件支持，可用 Syncthing 或局域网 NAS 托管数据源：
- 在 NAS 上创建共享文件夹（如
/volume1/sync/configs/obsidian-main），Mac 通过 SMB 挂载为/Volumes/NAS/configs/obsidian-main - 在每台 Mac 上执行：
ln -sf /Volumes/NAS/configs/obsidian-main ~/Documents/ObsidianVault - 优点：不依赖苹果生态、无容量限制、可审计；缺点：需维护挂载状态，断网时链接失效（建议配合自动重连脚本）
避坑提醒：这些操作会直接失败
以下常见做法看似省事，但实际会导致软链接断裂、权限报错或双端冲突：
- 把
~/.zshrc文件直接拖进 iCloud Drive 同步 → 软链接仍指向原路径，iCloud 不会自动修复链接 - 在 A Mac 上创建软链接指向
~/iCloud Drive/xxx，再把整个~/.dotfiles文件夹丢进 Dropbox → 多设备同时写入引发冲突，链接目标路径在各设备上解析不一致 - 用 Finder 别名代替终端软链接 → 别名在终端、脚本、开发工具中完全不生效
- 未清空旧本地缓存就建新链接（如 OpenClaw、Logseq）→ 旧配置持续覆盖新同步内容，导致状态混乱
