macOS用户配置迁移核心是将环境抽离设备、结构化复用：iTerm2用iCloud软链同步，Shell配置用Git+符号链接，SSH密钥推荐Termius加密同步或仅Git管理config文件，桌面/文稿通过iCloud云盘统一同步。
macOS 用户配置文件迁移与同步，核心在于把个人环境“抽离出设备”，变成可跨机器复用的结构化资产。不是复制粘贴，而是靠路径解耦 + 同步机制 + 符号链接生效。
iTerm2 配置同步（苹果生态友好）
iTerm2 支持自定义配置路径，配合 iCloud 可实现低干预同步：
- 确保 iCloud Drive 已开启，“桌面与文稿”同步也已启用
- 执行命令将原始 plist 文件软链到 iCloud 目录：
ln -sf ~/Library/Preferences/com.googlecode.iterm2.plist ~/Library/Mobile\ Documents/com~apple~CloudDocs/iTerm2/com.googlecode.iterm2.plist - 打开 iTerm2 → Preferences → General → Preferences，勾选“Load preferences from a custom folder”，路径填：
~/Library/Mobile Documents/com~apple~CloudDocs/iTerm2 - 重启 iTerm2，在一台设备改 Profile 名称，另一台等 5–10 分钟刷新即可验证
Shell 配置同步（zsh / oh-my-zsh / p10k）
把 .zshrc、.p10k.zsh、.zsh_aliases 等纳入 Git 管理，再通过符号链接挂载：
- 新建统一配置目录：
mkdir -p ~/.dotfiles && cd ~/.dotfiles && git init - 迁移当前配置：
mv ~/.zshrc ~/.dotfiles/zshrc
mv ~/.p10k.zsh ~/.dotfiles/p10k.zsh - 建立软链还原系统识别路径：
ln -s ~/.dotfiles/zshrc ~/.zshrc
ln -s ~/.dotfiles/p10k.zsh ~/.p10k.zsh - 提交推送到 GitHub/GitLab 私有仓库；新设备只需克隆 + 运行软链命令 + source ~/.zshrc
SSH 配置与密钥管理（安全优先）
~/.ssh 目录权限敏感，不建议直接用 iCloud 或 Dropbox 同步：
- 推荐使用 Termius：AES-256 端到端加密，自动同步主机配置、密钥片段、别名和会话设置，覆盖全平台
- 若坚持本地管理：仅将 ~/.ssh/config 文本导出并纳入 dotfiles Git 仓库（务必排除 id_rsa 等私钥）
- 新设备上用脚本生成最小权限密钥对：
chmod 600 ~/.ssh/id_rsa - 敏感密钥建议通过 1Password CLI 或 gopass 按需注入，避免明文落盘
用户数据基础层同步（桌面/文稿/iCloud）
这是最底层的文件级同步，影响所有应用的默认保存位置：
- macOS Sequoia 及更新版本：系统设置 → Apple ID → iCloud → iCloud云盘 → 勾选“桌面与文稿文件夹”，点击“移动”
- Sonoma 及更早版本：进入 iCloud云盘“选项…” → 切换到“桌面与文稿”标签页 → 勾选启用
- 成功后，访达侧边栏 iCloud云盘下会出现带云朵图标的“桌面”和“文稿”文件夹
- 注意：若此前已用 Dropbox / OneDrive 等接管过这两个文件夹，需先解除其管理，否则同步冲突
