按键绑定

Zed 可通过一个位于 ~/.config/zed/keymap.json 的简单 JSON 文件进行配置。

预定义按键映射

我们在 zed 仓库的按键映射文件夹 中收集了越来越多的预定义按键映射。我们当前的按键映射包括

• Atom
• JetBrains
• SublimeText
• TextMate
• VSCode（默认）

这些按键映射可以通过 settings.json 文件中的 base_keymap 设置进行设置。此外，如果你想从一个干净的状态开始，你可以向该设置提供 "None"。

自定义按键绑定

访问自定义按键绑定

你可以通过 ⌘ + K、⌘ + S、命令面板或 Zed > 设置 > 打开按键绑定 应用程序菜单项打开 keymap.json。

添加自定义按键绑定

要自定义按键绑定，请指定一个上下文和要设置的绑定列表。重新映射现有绑定将覆盖现有绑定，转而使用自定义绑定。

添加一组自定义按键绑定的示例

[
  {
    "context": "Editor",
    "bindings": {
      "ctrl-w": "editor::SelectLargerSyntaxNode",
      "ctrl-shift-W": "editor::SelectSmallerSyntaxNode",
      "ctrl-c": "editor::Cancel"
    }
  }
]

你可以在 Zed 的 default.json 中看到更多示例。

有一些按键绑定无法覆盖；我们正在解决与此相关的问题。

按键绑定语法

Zed 不仅可以匹配单个按键，还可以匹配按顺序键入的按键序列。"bindings" 映射中的每个键都是一个按键序列，用空格分隔。

每个按键都是一个修饰符序列，后跟一个键。修饰符是

• ctrl- 控制键

• cmd-、win- 或 super- 用于平台修饰符（macOS 上的 Command、Windows 上的 Windows 键和 Linux 上的 Super 键）。

• alt- 用于 alt（macOS 上的 option）
• shift- Shift 键
• fn- Function 键

这些键可以是键盘生成的任何单个 Unicode 代码点（例如 a、0、£ 或 ç），或任何已命名的键（tab、f1、shift 或 cmd）。

几个示例

 "bindings": {
   "cmd-k cmd-s": "zed::OpenKeymap", // matches ⌘-k then ⌘-s
   "space e": "editor::Complete", // type space then e
   "ç": "editor::Complete", // matches ⌥-c
   "shift shift": "file_finder::Toggle", // matches pressing and releasing shift twice
 }

shift- 修饰符只能与字母结合使用，以表示大写版本。例如，shift-g 与键入 G 相匹配。尽管在许多键盘上，shift 用于键入标点符号（如 (），但不会将此击键视为已修改，因此 shift-( 不匹配。

alt- 修饰符可在许多布局中用于生成不同的键。例如，在 macOS 美国键盘上，组合 alt-c 会键入 ç。您可以在键映射文件中与任一匹配，但根据惯例，Zed 将此组合拼写为 alt-c。

可以匹配单独键入修饰键。例如，shift shift 可用于实现 JetBrains 搜索无处不在的快捷方式。在这种情况下，绑定在松开键时发生，而不是按下键时。

重新映射键

一个常见的要求是从一组键映射到另一组键。从 Zed 0.124.0 开始，您可以使用 workspace::SendKeystrokes 操作来执行此操作。

[
  {
    "bindings": {
      "alt-down": ["workspace::SendKeystrokes", "down down down down"],
      "cmd-alt-c": [
        "workspace::SendKeystrokes",
        "cmd-shift-p copy relative path enter"
      ],
      "cmd-alt-r": ["workspace::SendKeystrokes", "cmd-p README enter"]
    }
  },
  {
    "context": "Editor && vim_mode == insert",
    "bindings": {
      "j k": ["workspace::SendKeystrokes", "escape"]
    }
  }
]

对此有一些限制，特别是

• 任何异步操作都将在分派所有键绑定后才会发生。例如，这意味着虽然您可以使用绑定打开文件（如 cmd-alt-r 示例中所示），但您无法发送进一步的击键并希望它们被新视图解释。
• • 异步操作的其他示例包括：与语言服务器通信、更改缓冲区的语言、任何访问网络的操作。
• 一次最多模拟 100 个按键，这是为了避免在绑定中再次触发 SendKeystrokes 时意外发生无限递归。

SendKeystrokes 的参数是空格分隔的按键列表（使用与上面相同的语法）。由于按键的解析方式，任何未被识别为按键的段落都将逐字发送到当前聚焦的输入字段。

将按键转发到终端

如果你在 Linux 或 Windows 上，你可能会希望将按键组合转发到内置终端，而不是由 Zed 处理。

例如，ctrl-n 在 Linux 上的 Zed 中创建一个新选项卡。如果你想在内置终端获得焦点时向其发送 ctrl-n，请将以下内容添加到你的按键映射中

{
  "context": "Terminal",
  "bindings": {
    "ctrl-n": ["terminal::SendKeystroke", "ctrl-n"]
  }
}

任务按键绑定

你还可以将按键绑定到在 tasks.json 中定义的启动 Zed 任务。请参阅 任务文档 了解更多信息。

所有按键绑定

全局

编辑器

编辑器（仅完整版）

编辑器（仅自动高度）

窗格

缓冲区搜索栏

工作区

项目面板

项目搜索栏

终端

辅助编辑器