从 iTerm2 迁移至 Warp

Warp 会自动导入你的 iTerm2 配置文件，只需几次点击即可同步主题、字体、键位绑定、热键窗口等。本页面将介绍导入程序、涵盖的内容以及导入后需要手动重新配置的项目。

自动迁移的内容

Warp 附带了一个内置的 iTerm2 导入程序，它会读取你 ~/Library/Preferences/com.googlecode.iterm2.plist 中的默认配置文件。它导入的内容包括：

• 主题 - 前景色、背景色、光标及所有 16 种 ANSI 颜色（如果已配置，还包括浅色和深色变体）。
• 字体 - 字族和字号（前提是该字体在你的系统中存在并受 Warp 支持）。
• 默认 Shell - 如果你在 iTerm2 配置文件中设置了自定义命令。
• 工作目录行为 - Warp 会转换 iTerm2 的“复用之前会话的目录”及类似选项。
• 窗口尺寸 - 行数和列数。
• 不透明度和模糊效果。
• 选中即复制、鼠标和滚动报告，以及 Option 作为 Meta 键的设置。
• 全局热键 - 如果你使用了热键窗口或热键激活功能，Warp 会对其进行映射。

运行导入程序的步骤

1. 在 Warp 中，打开 命令面板。
2. 搜索 Import External Settings（导入外部设置）。
3. 选择 iTerm2 Profile: Default。Warp 仅导入在 iTerm2 中标记为默认书签的配置文件。
4. 在预览屏幕中选择要保留或跳过的设置。

选择要导入的设置配置文件。

使用 Warp 的 Agent 进行后续设置

如果导入程序没有提取到你关注的内容——例如非默认配置文件、不常见的键位绑定或特定设置——可以直接要求 Warp 的 Agent 进行转换。Warp 附带了一个 settings.toml 文件和一个内置的 modify-settings 技能，允许 Agent 读取你的 iTerm2 plist 文件并将等效值写入 Warp 的设置中。

1. 在 Warp 中，使用 ⌘+I 切换到 Agent 模式。

2. 输入如下提示词

   使用 defaults read com.googlecode.iterm2 读取我的 iTerm2 偏好设置，并将导入程序未涵盖的任何设置（额外的配置文件、自定义键位绑定）使用 modify-settings 技能迁移到我的 Warp settings.toml 中。在应用前向我展示差异。

3. 查看建议的差异并批准。Warp 将热重载 settings.toml。

需要手动重新配置的内容

少数 iTerm2 功能无法直接映射，导入后需要手动处理

• 多个配置文件。 Warp 仅导入你的默认配置文件。如果你依赖多个 iTerm2 配置文件，请在 Warp 中创建等效的 标签页配置。
• 键盘快捷键。 Warp 的 键盘快捷键开箱即用，涵盖了大多数 iTerm2 绑定，但自定义绑定需要在 Settings（设置）> Keyboard shortcuts（键盘快捷键）中重新创建。
• 拆分窗格和排列。 请使用 拆分窗格 和 标签页配置 进行重建。
• 触发器。 Warp 没有直接的等效功能。可以通过 YAML 工作流 或 Agent 模式达到类似效果。

选择你的提示符

导入后，选择要使用的 提示符

1. Warp 提示符 - Warp 原生提示符，带有用于 Git 分支、目录、时间戳等信息的拖放式上下文芯片。在 Settings（设置）> Appearance（外观）> Prompt（提示符）中进行配置。
2. Shell 提示符 (PS1) - 原样继承你现有的 Shell 提示符配置。如果你希望 Warp 完全匹配你的 iTerm2 提示符，请选择此项。

Warp 原生对应功能

迁移者在离开 iTerm2 后通常会寻找的功能及其在 Warp 中的位置

从 iTerm2	在 Warp
热键窗口 (Quake 模式)	全局热键 (在 iTerm2 配置文件中检测到时自动导入)
触发器	YAML 工作流 用于可重复操作；Agent 模式用于基于模式的自动化
配置文件	标签页配置 用于布局；Warp Drive 用于共享团队设置
自动补全菜单	自动建议 + Tab 补全
即时回放	会话恢复
密码管理器集成	Warp Drive 环境变量

有关迁移后可配置内容的更多信息，请参阅 Warp 快速入门 和 自定义 Warp。