从 Windows 终端迁移至 Warp

Windows 上的 Warp 涵盖了你现在使用 Windows Terminal 的所有功能 —— 配置文件、PowerShell、配色方案、按键绑定 —— 此外还增加了 Agent 模式和块 (blocks) 功能。本页面将引导你完成迁移。

自动迁移的内容

Warp 目前没有内置 Windows Terminal 导入器，但它可以通过 Agent 以智能化的方式为你完成大部分工作。Windows Terminal 的设置存储在以下路径的一个 JSON 文件中：

%LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json

使用 Warp 智能体迁移设置（推荐）

迁移 Windows Terminal 设置最快的方法是直接让 Warp 的 Agent 翻译 settings.json。Warp 提供了一个 settings.toml 文件 和一个内置的 modify-settings 技能，允许 Agent 读取你现有的配置并向 Warp 的设置中写入等效值，包括将你的配色方案转换为 Warp 自定义主题。

1. 在 Warp 中，打开一个新标签页并使用 Ctrl+I 切换到 Agent 模式。

2. 输入如下提示词

   读取位于 %LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json 的 Windows Terminal settings.json 文件，并使用 modify-settings 技能将当前激活的配置文件和配色方案迁移到我的 Warp settings.toml 中。创建一个匹配的自定义主题。在应用之前显示差异 (diff)。

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

如果你更倾向于通过设置界面手动配置各项设置，下文涵盖了最常见的情况。

需要手动重新配置的内容

默认 Shell

Windows 上的 Warp 支持 PowerShell (pwsh 和 powershell.exe)、命令提示符 (cmd)、bash、zsh 和 fish。Warp 会自动检测你的登录 shell；如需覆盖，请前往 Settings > Features > Session，并在 Startup shell for new sessions 中选择一个 shell。

如果你使用了 PowerShell 模块或自定义的 $PROFILE，Warp 会像 Windows Terminal 一样加载它们。

配置文件

Windows Terminal 使用配置文件 (profiles) 将 shell、主题、起始目录和字体组合在一起。Warp 没有单一的“配置文件”概念；相反，你需要分别配置每个维度：

• Shell - Settings > Features > Session。
• 起始目录 - Settings > Features > Session > Working directory。
• 字体族、大小 - Settings > Appearance > Text, fonts, & cursor。
• 配色方案 - Settings > Appearance > Themes。使用相同的 16 个 ANSI 颜色值将你的 Windows Terminal 配色方案转换为 自定义 Warp 主题。
• 可重用的布局 - 为以前作为配置文件的每个工作流创建一个 标签页配置 (tab config)。

配色方案

Windows Terminal 的 schemes 数组定义了前景色、背景色、光标颜色和 ANSI 颜色。要匹配现有方案：

1. 从 `settings.json` 中使用的方案中复制颜色值。
2. 在 Warp 中打开 Settings > Appearance > Themes，选择匹配的预设或 创建自定义主题。

快捷键

Warp 的 默认快捷键 涵盖了大多数 Windows Terminal 的绑定。对于 settings.json 中 actions 数组里的自定义绑定，请在 Settings > Keyboard shortcuts 中添加。

提示符 (Prompt)

如果你使用 oh-my-posh 或自定义的 PowerShell 提示符，它在 Warp 中可以继续工作。要在 Warp 原生提示符和现有 shell 提示符之间切换，请前往 Settings > Appearance > Prompt。请参阅 提示符。

Warp 原生对应功能

Windows Terminal 用户常在 Warp 中寻找的功能：

源自 Windows Terminal	在 Warp
配置文件	标签页配置 + 主题 + 每个会话的 shell 设置
标签页和分栏	标签页、垂直标签页、拆分窗格
命令面板	命令面板 (Ctrl+Shift+P)
Oh My Posh 提示符	继续使用；在 Warp 中选择 Shell 提示符 (PS1)
Quake 模式	全局热键

除了 Windows Terminal 的功能集外，Warp 还增加了 Agent 模式、块 (blocks) 和 Warp Drive。如果你尚未安装，请参阅 Warp for Windows 安装指南。