启动配置 (旧版)

注意

启动配置已被 标签页配置 取代。现有的启动配置仍可继续使用，但不再添加新功能。对于新的设置，请使用 标签页配置。

它是什么

借助启动配置，您可以在应用内进行保存，或者通过添加 YAML 文件来进行配置。

创建启动配置

从 UI 创建

1. 设置好您想要保存的窗口、标签页和窗格配置。
2. 打开 命令面板，然后输入 Save New Launch Configuration。
3. 为配置文件命名。名称字段不能为空。
4. 点击“Save configuration”（保存配置）按钮。

使用 YAML 文件创建

• 启动配置文件在您通过 UI 创建时会自动生成，也可以手动创建或修改。
• 请参阅下方关于 启动配置 YAML 文件位置、格式及示例 的内容。

使用启动配置

macOS

• 从 命令面板 输入 Launch Configuration 以打开并选择启动配置。
• 右键点击新的“标签页 +”按钮，打开菜单并选择已保存的启动配置。
• 从 macOS 菜单栏选择 File（文件） > Launch Configurations（启动配置），您可以在其中搜索并打开已保存的启动配置。
  • 使用 macOS 上的 CMD-ENTER，可以将单窗口启动配置加载到当前激活的窗口中。

Windows

• 从 命令面板 输入 Launch Configuration 以打开并选择启动配置。
• 右键点击新的“标签页 +”按钮，打开菜单并选择已保存的启动配置。
  • 在 Linux 上，可以使用 CTRL-ENTER 将单窗口启动配置加载到当前激活的窗口中。

要使用启动配置打开 WSL 标签页，您必须先在 Warp 中将 WSL 设置为默认 Shell

• 前往 Settings（设置） > Features（功能） > Session（会话） > Startup shell for new sessions（新会话的启动 Shell）。
• 选择您所需的 WSL 发行版（例如 Ubuntu）作为默认 Shell。

完成此操作后，您打开的任何启动配置都将使用 WSL 作为 Shell。

Linux

• 从 命令面板 输入 Launch Configuration 以打开并选择启动配置。
• 右键点击新的“标签页 +”按钮，打开菜单并选择已保存的启动配置。
  • 在 Linux 上，可以使用 CTRL-ENTER 将单窗口启动配置加载到当前激活的窗口中。

提示

终端提示
您可以通过 Alfred 工作流或 Raycast 扩展程序打开已保存的启动配置。在此 了解更多信息。感谢 @joetannenbaum 的贡献

工作原理

启动配置 YAML 格式

所有启动配置 YAML 文件都存储在以下位置

macOS

$HOME/.warp/launch_configurations/

Windows

$env:APPDATA\warp\Warp\data\launch_configurations\

Linux

${XDG_DATA_HOME:-$HOME/.local/share}/warp-terminal/launch_configurations/

注意

YAML 代码中的 cwd: 值必须包含绝对路径或 ""。请注意，使用 ~ 或留空将导致该文件无法在启动配置选项列表中显示。

Windows

示例配置，展示了启动配置文件中窗口的结构。

# Warp Launch Configuration
#
# This configuration has two windows,
# each with one tab in different starting directories.

---
name: Example Windows
windows:
  - tabs:
      - title: Documents
        layout:
          cwd: /Users/warp-user/Documents
        color: blue
  - tabs:
      - title: Warp User
        layout:
          cwd: /Users/warp-user
        color: green

标签页

下面是一个示例配置，展示了启动配置文件中标签页的结构。

• 使用 title 字段设置自定义标签页名称
• 使用 color 字段设置标签页颜色

  • 我们目前支持使用终端颜色（ANSI 颜色）

    Red（红） | Green（绿） | Yellow（黄） | Blue（蓝） | Magenta（洋红） | Cyan（青）

    实际颜色值将自动从您的 Warp 主题中获取

# Warp Launch Configuration
#
# This configuration has two tabs in the same window.

---
name: Example Tabs
windows:
  - tabs:
      - title: Documents
        layout:
          cwd: /Users/warp-user/Documents
        color: blue
      - title: Warp User
        layout:
          cwd: /Users/warp-user
        color: green

窗格

启动配置支持在每个标签页中设置拆分窗格。请注意，Warp 也支持在启动配置文件中嵌套拆分窗格。

# Warp Launch Configuration
#
# This configuration is two windows, each with split panes.
# The first window contains a vertically split tab with two panes.
# The second window contains a horizontally split tab,
# with a vertically split tab on the right.

---
name: Example Panes
windows:
  - tabs:
      - title: Downloads and Warp User
        layout:
          split_direction: vertical
          panes:
            - cwd: /Users/warp-user/Downloads
            - cwd: /Users/warp-user
        color: blue
  - tabs:
      - title: Desktop, Documents, and Warp User
        layout:
          split_direction: horizontal
          panes:
            - cwd: /Users/warp-user/Desktop
            - split_direction: vertical
              panes:
                - cwd: /Users/warp-user/Documents
                - cwd: /Users/warp-user
        color: green

激活与聚焦

示例配置展示了如何激活窗口和标签页，并聚焦于特定会话。

• 使用 active_window_index 和 active_tab_index 字段来设置激活的窗口和标签页。
• 使用 is_focused 字段设置每个标签页中聚焦的窗格。

注意

请注意，当您使用 - active_tab_index: 时，tabs: 字段不需要 - 前缀，否则可能导致语法错误。

# Warp Launch Configuration
#
# This configurations has two tabs, with the second tab active.
# Two vertical split panes in the first tab and the top pane focused.
# Two horizontal split panes in the second tab and the right pane focused.
---
name: Example Active and Focus
active_window_index: 0
windows:
  - active_tab_index: 1
    tabs:
      - title: Tab 1
        layout:
          split_direction: vertical
          panes:
            - cwd: /Users/warp-user/Documents
              is_focused: true
            - cwd: /Users/warp-user/Documents/Projects
      - title: Tab 2
        layout:
          split_direction: horizontal
          panes:
            - cwd: /Users/warp-user/Downloads
            - cwd: /Users/warp-user
              is_focused: true

命令

使用 commands 字段来定义运行启动配置时要执行的一组命令。

注意

对于包含特殊字符的命令，您可能需要使用双引号。分行的命令在运行时会通过 && 连接，因此在 ssh 命令之后运行的命令可能不会执行。

# Warp Launch Configuration
#
# This configuration has two windows,
# the first window executes two commands on start,
# the second window has a split pane that executes a command on start.

---
name: Example Commands
windows:
  - tabs:
      - title: Documents
        layout:
          cwd: /Users/warp-user/Documents
          commands:
            - exec: ls
            - exec: code .
        color: blue
  - tabs:
      - title: Downloads
        layout:
          split_direction: vertical
          panes:
            - cwd: /Users/warp-user/Downloads
              commands:
                - exec: curl http://example.com -o my.file
                - exec: cp my.file my.file2
            - cwd: /Users/warp-user
              commands:
                - exec: ssh user@remote.server.com
        color: green