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 等接管过这两个文件夹,需先解除其管理,否则同步冲突











