如何将iTerm2的profile、命令历史等有用数据从旧Mac迁移至新Mac

针对3.4.4版本的iTerm2，不存在可以直接整体拷贝的独立专属配置文件夹，核心配置完全存储在系统偏好存储的plist文件中，配合Shell历史文件，即可实现接近100%的使用体验一致迁移。

需要迁移的完整内容清单 #

• iTerm本体全量配置：包含所有Profile会话设置、窗口布局记忆、自定义按键映射、外观主题、快捷键配置、自动补全规则、脚本触发规则等所有和iTerm功能相关的参数
• Shell命令历史：这部分内容不属于iTerm自身的存储范畴，跟随系统默认Shell存在用户根目录的隐藏文件中
• 可选关联内容：iTerm保存的窗口快照、自定义加载的插件脚本等

旧Mac设备上的导出操作 #

导出iTerm核心配置 #

两种可选择的导出方式：

1. 直接拷贝核心配置文件
   iTerm所有核心配置集中存储在路径 ~/Library/Preferences/com.googlecode.iterm2.plist 中，这就是最接近“专属文件夹”的配置载体。打开访达，按Shift + Command + G粘贴上述路径，定位到文件后直接拷贝到外置存储或通过AirDrop传输即可。

   注意：导出前必须完全退出旧设备上的iTerm2，否则系统会在iTerm退出时，用内存中缓存的旧配置覆盖刚拷贝出来的plist文件，导致导出的配置不完整。

2. iTerm自带图形化导出
   打开iTerm2，点击顶部菜单栏的 iTerm2 > Settings > General，找到页面最下方的 Load preferences from a custom folder or URL 选项，点击旁边的Browse，选择一个自定义的备份目录，等待系统把全量iTerm配置导出到指定目录即可。

导出Shell命令历史 #

根据你使用的Shell类型，找到对应历史文件拷贝即可：

• 系统默认zsh：历史文件路径为 ~/.zsh_history
• 传统bash：历史文件路径为 ~/.bash_history
• 如果你之前自定义过历史文件的存储路径，按自己配置的实际路径定位文件即可

新Mac设备上的导入操作 #

新设备上先完成iTerm2安装，暂时不要启动打开iTerm，避免生成默认配置覆盖导入的文件。

导入iTerm核心配置 #

对应之前的导出方式选择操作：

1. 直接文件覆盖导入
   打开访达，按Shift + Command + G定位到路径 ~/Library/Preferences/，把从旧设备拷贝来的com.googlecode.iterm2.plist粘贴到该目录，替换掉新设备自动生成的同名默认文件即可。
2. 图形化导入
   打开已安装的iTerm2，点击顶部菜单栏的 iTerm2 > Settings > General，找到 Load preferences from a custom folder or URL 选项，点击Browse选择之前导出的备份目录，确认后在弹出的重载提示中选择确认，所有iTerm配置就会自动加载完成。

导入Shell命令历史 #

关闭新设备上所有已打开的终端、iTerm窗口，把之前导出的对应Shell历史文件（.zsh_history或.bash_history）粘贴到新设备的用户根目录~下，替换系统默认生成的空历史文件。重新打开iTerm后，按下方向键就能调出之前的所有历史命令。

迁移注意事项 #

• 版本尽量匹配：建议新设备安装和旧设备一致的iTerm2 3.4.4版本，更高版本的iTerm一般可以向下兼容低版本导出的配置，但低版本iTerm无法正常识别高版本导出的配置参数，容易出现设置丢失的问题
• 权限检查：导入完成后如果发现部分配置失效，打开系统设置的隐私与安全性面板，给iTerm开启完全磁盘访问权限即可解决大部分路径读取类的问题
• 路径类配置适配：旧设备上写死的本地绝对路径，在新设备上需要确认相同路径存在，否则对应功能会提示找不到对应文件

内容的提问来源于stack exchange，提问作者iammrmehul