功能定位：为什么必须把自定义短语放进iCloud
在 Mac 上积累的三千条快捷短语（如「addr=北京市朝阳区建国路88号」）一旦丢失，重新敲一遍的成本远高于首次配置。搜狗输入法在 2026 年 4 月之后把「自定义短语」从本地 plist 单文件拆成「本地缓存+云端合并」双轨结构，核心目的就是降低换机、重装、双系统切换时的重复录入成本。iCloud 同步是官方提供的唯一跨苹果生态通道，区别于 Windows 版用的「搜狗账号云词库」，它能在 macOS、macOS 恢复模式、甚至迁移助理场景下保持条目顺序与触发键不变。
经验性观察：同一账号下短语条目 ≤5000 条时，完整同步耗时在「数十秒内」；超过八千条后首次上传可能触发 iCloud 节流，需手动点「立即同步」二次触发。验证方法见文末「观测指标」一节。
前置检查清单：版本、账号与权限
1. 客户端版本
截至当前的最新版本（Mac 13.4 Beta 2）才内置「iCloud 自定义短语」开关；若你停留在 12.x，设置面板不会出现相关选项，必须先更新。
2. 系统级前提
- macOS 11 Big Sur 及以上（iCloud Drive 需支持「按需同步」）
- 已登录同一 Apple ID，且 iCloud Drive 总开关打开
- 给予「搜狗输入法」完全磁盘访问权限（系统设置→隐私与安全→完全磁盘访问），否则读取旧短语会失败
以上三项缺一不可，建议在升级前一次性核对，避免来回重启设置面板。
3. 搜狗账号≠必须
与 Windows 版不同，Mac 版自定义短语走 iCloud 容器，不强制绑定搜狗通行证。若你之前用搜狗账号同步过「用户词库」，可在「设置→账户」里退出，仅保留 iCloud 通道，减少隐私上传点。
三步开启：最短操作路径
- 在菜单栏点「输入法图标→设置→高级→自定义短语」
- 右上角可见「iCloud 同步」开关，首次开启会弹窗「合并 or 覆盖」：
合并：本地+云端条目同时保留，冲突时以本地时间戳为准
覆盖：用云端快照完全替换本地，适合重装后恢复
3. 点「合并」→「立即同步」，状态栏出现绿色云图标即代表上传完成。
提示
若你同时有多台 Mac，需在第二台机器重复步骤 1-2，但选择「合并」即可自动拉取第一台上传的短语，无需手动导出。
平台差异：iPhone 与 iPad 能否直接同步？
目前 iOS 版搜狗输入法尚未开放「自定义短语」iCloud 通道，仅支持「用户词库」与「AI 写作模板」通过搜狗账号同步。因此 Mac 端同步到 iCloud 后，并不能在 iPhone 或 iPad 的搜狗输入法内直接触发；若需在移动设备使用相同快捷码，可借助「系统设置→通用→键盘→文本替换」作为折中，但需手动维护两套。
示例：把「addr」做成系统级文本替换后，iPhone 在任何输入法下都能展开，但宏指令与顺序无法与 Mac 端保持一致。
例外与取舍：哪些内容不会被同步
- 带宏指令的「动态短语」如{DATE}、{CLIPBOARD}，因 macOS 沙箱限制会被过滤
- 单条短语长度>500字符，上传时会被拆分或拒绝，界面提示「条目过长」
- 含有 Emoji 的短语在 macOS 12 与 13 之间可能出现编码回退，经验性观察：升级到最新小版本可缓解
当项目团队共享同一 Apple 开发者账号做设备测试时，若打开 iCloud 同步，私人地址也会被同步到同事电脑。此时可在「系统设置→Apple ID→iCloud→iCloud Drive→选项」里取消「搜狗输入法」勾选，回退为纯本地。
验证与观测：确认同步真的成功
1. 本地文件时间戳
打开终端，执行
ls -l ~/Library/Mobile\ Documents/iCloud~com~sogou~inputmethod/Documents/CustomPhrase/
若看到「Modified」时间在点击「立即同步」后更新，即代表容器已写入 iCloud Drive。
2. 第二台 Mac 拉取测试
在另一台电脑新建短语「testsync=20260501」，回到第一台电脑输入「testsync」应能立即候选「20260501」。若未出现，检查「系统设置→iCloud→iCloud Drive」是否开启「按需同步」，或手动点「下载原始文件」。
故障排查：常见卡住场景
| 现象 | 最可能原因 | 处置 |
|---|---|---|
| 开启开关即提示「iCloud 不可用」 | 完全磁盘访问未给搜狗 | 系统设置→隐私与安全→完全磁盘访问，勾选 SogouInput |
| 绿色云图标持续旋转 | 条目数>8000 触发节流 | 分批次删除早期无用短语，再点「立即同步」 |
| 第二台 Mac 提示「冲突」 | 时间戳相同但内容不同 | 选手动合并，导出本地 CSV 备份后再覆盖 |
适用/不适用场景清单
- 适用：个人双 Mac、家庭 iMac+MacBook、公司设备用自己的 Apple ID 登录
- 不适用：多人共用 Apple ID、macOS 10.15 及以下、需与 Windows 共用短语、条目>1 万条且每日频繁增删
在「不适用」场景下，建议改用 CSV 导出+脚本定时比对，避免 iCloud 节流与隐私交叉污染。
最佳实践：把同步纳入日常运维
- 每月首工作日点「立即同步」一次，确保 iCloud Drive 未因空间不足暂停
- 每季度导出 CSV（设置→高级→自定义短语→导出）到外部磁盘，防止 Apple ID 被封等极端场景
- 新增业务短语后，用「test+日期」做临时条目，验证同步正常后再批量导入
把这三步写进日历提醒，可让短语库成为「无感基础设施」，而不再是一次性配置。
FAQ：必须用 FAQPage Schema
iCloud 同步后，短语顺序会乱吗？
不会。搜狗按「触发键+创建时间」排序，合并策略以本地时间戳为准，经验性观察：千条以内顺序保持一致。
关闭 iCloud 同步会删除本地短语吗？
不会。关闭后本地条目保留，但不再上传；已上传文件会留在 iCloud Drive，可手动清理。
能否与 Windows 版共用？
不能直接共用。Windows 版使用搜狗账号云词库，需借助导出 CSV→Windows 端导入的折中方案。
收尾结论与下一步
Mac 版搜狗输入法的自定义短语 iCloud 同步，是苹果生态内成本最低、可靠性最高的换机方案。只要版本、权限、条目规模三项前置达标，「开开关→点合并→每月校验」即可在十分钟内完成部署。未来若 iOS 端开放同一容器，将有望实现「Mac-iPhone 短语无缝」；届时只需在 iPhone 设置里打开同一开关，就能直接沿用 Mac 端数千条快捷码，无需再维护两套文本替换。下一步：建议把 CSV 季度备份写进个人 SOP，并关注官方更新日志，第一时间验证跨平台同步是否落地。