iCloud 不适合同步 Sublime Text 配置，因其与 Sublime 运行机制冲突，尤其在 macOS 上导致插件不加载、快捷键失效、代码片段失效等问题；应改用 Dropbox 或坚果云配合符号链接。
iCloud 不适合用来同步 Sublime Text 配置，强行使用会导致插件不加载、快捷键失效、代码片段静默跳过等故障。 它不是“同步慢一点”的问题，而是设计上就与 Sublime 的运行机制冲突——尤其在 macOS 上，iCloud 对 ~/Library/ 下文件的同步行为不可靠，且无法处理跨平台换行符、缓存隔离、路径校验等关键环节。
为什么 iCloud 同步 Packages/User 会失败
iCloud 会尝试同步整个目标目录，但 Sublime 的 User/ 目录必须与本地运行时状态严格隔离。常见后果包括：
-
Session.sublime_session被同步后，另一台设备启动 Sublime 时会因会话冲突卡在 “Loading packages…” - iCloud 自动注入
.DS_Store或临时锁文件（如.sublime-keymap~），导致 XML 解析失败，.sublime-snippet按 Tab 不触发，且无任何错误提示 - iCloud 同步
~/Library/Application Support/Sublime Text 4/Packages/User时，常把部分子目录同步为只读或延迟挂载，Sublime 重启后读到空目录，所有自定义设置消失 - macOS 的 iCloud Drive 默认不监控
~/Library/深层路径，即使开启“桌面与文稿”，也无法覆盖 Application Support 下的任意子路径
如果你已用 iCloud 尝试同步，现在该做什么
立即中止，并恢复干净状态：
- 退出 Sublime Text（检查活动监视器，确认无后台进程）
- 删除
~/Library/Application Support/Sublime Text 4/Packages/User的符号链接（如果存在） - 从 iCloud 云盘中彻底移除原
User文件夹（不要仅“移出”或“取消同步”，要物理删除） - 重新通过
Preferences → Browse Packages…打开默认User目录，确认它已重建且可写 - 手动复制回你真正需要的配置文件：
Preferences.sublime-settings、Package Control.sublime-settings、Default (OSX).sublime-keymap、*.sublime-snippet
替代方案：Dropbox / 坚果云 + 符号链接才是可行路径
它们对路径控制更直接，不干涉文件属性，且支持明确的同步状态反馈。实操要点：
- 路径必须用
Preferences → Browse Packages…确认，ST4 用户注意是Sublime Text 4，不是3 - macOS 终端执行：
ln -s ~/Dropbox/SublimeConfig/User ~/Library/Application\ Support/Sublime\ Text\ 4/Packages/User
- Windows 必须用管理员权限 CMD：
mklink /J "C:\Users\用户名\AppData\Roaming\Sublime Text 4\Packages\User" "D:\Dropbox\SublimeConfig\User"
- 同步前务必关闭 Sublime；同步后首次启动时，等 Dropbox 图标变绿再操作，避免软链接指向未就绪目录
- 若用坚果云，需在客户端设置中启用“完整同步”，禁用“智能同步”（后者可能让文件以占位符形式存在）
最易被忽略的一点：Sublime 启动时若发现 User/ 下的 Package Control.sublime-settings 里 installed_packages 列表非空，但对应插件目录不存在，它不会自动重装——你得手动执行 Ctrl+Shift+P → Package Control: Satisfy Dependencies 或重启后等待 Package Control 自检完成。这和同步工具无关，是 Sublime 自身加载逻辑决定的。
