Mac完整迁移zsh配置需打包配置文件、Oh My Zsh框架、iTerm2设置、Powerline字体四部分；导出时分别复制.zshrc/.zprofile、压缩~/.oh-my-zsh、导出iTerm2配置JSON、打包对应字体文件；导入时依次安装依赖、恢复框架、覆盖配置、导入iTerm2设置、安装并指定字体；最后验证PATH、插件补全与主题渲染。
mac 上导出和导入完整的 zsh 配置方案，核心是打包配置文件 + 插件 + 主题 + 字体设置四个部分。单独复制 .zshrc 文件远远不够——它只存变量和插件声明，而插件本体、oh my zsh 框架、powerline 字体、iterm2 颜色/字体偏好等都不在其中。真正“完整可迁移”的方案，必须覆盖这四层。
一、导出：打包所有必要组件
执行以下步骤，生成一个可复用的压缩包：
-
配置文件：复制
~/.zshrc和~/.zprofile（如有自定义登录环境）到临时文件夹 -
Oh My Zsh 框架：默认装在
~/.oh-my-zsh，直接压缩整个目录（含custom/plugins/下手动安装的插件） -
iTerm2 设置：打开 iTerm2 → Preferences → Profiles → Other Actions → Export All Profiles，保存为
iterm2-profiles.json -
Powerline 字体：若用了
Roboto Mono for Powerline等字体，从/Library/Fonts/或~/Library/Fonts/找到对应.ttf或.otf文件一并打包
二、导入：分步还原，避免冲突
在新 Mac 或重装后按顺序操作：
-
先装基础依赖：确保已安装 Homebrew、Git、iTerm2；运行
chsh -s /bin/zsh设为默认 shell -
恢复 Oh My Zsh：解压
.oh-my-zsh到~目录，保持路径一致；不要重复运行官方 install.sh，否则会覆盖 -
放回配置文件：把备份的
.zshrc覆盖到~/.zshrc；执行source ~/.zshrc测试是否报错 -
导入 iTerm2 设置：iTerm2 → Preferences → Profiles → Other Actions → Import JSON File，选中导出的
iterm2-profiles.json -
安装字体：双击解压出的
.ttf文件，点击“安装字体”；再进 iTerm2 → Profiles → Text → Change Font，选中该字体
三、验证与微调
导入后重点检查三项是否生效：
-
PATH 是否完整：运行
echo $PATH，确认 Node、Python、Homebrew bin 路径都在其中 -
插件是否工作：输入
git后按Tab，看是否有补全；输入历史命令前半段，看zsh-autosuggestions是否显示灰色提示 -
主题是否渲染正常：如果
agnoster主题显示乱码，说明字体未生效或未在 iTerm2 中正确指定；检查ZSH_THEME="agnoster"和字体设置是否匹配
四、进阶建议：让迁移更可靠
日常就养成这些习惯，下次迁移就不慌：
- 把
.zshrc和.oh-my-zsh/custom放进私有 Git 仓库，每次修改都提交，版本可控 - 插件尽量用
git clone方式安装到custom/plugins/，避免用brew install——后者装在系统路径，不随配置迁移 - 在
.zshrc开头加一行：export ZSH_CUSTOM="$HOME/.dotfiles/ohmyzsh-custom"，把自定义内容集中管理，导出时只打包这个目录即可
