快捷鍵

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- 功能鍵

按鍵可以是您的鍵盤產生的任何單個 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 任務。如需詳細資訊，請參閱任務文件。

所有快捷鍵

全域

編輯器

編輯器（僅限完整模式）

編輯器（僅限自動調整高度）

窗格

緩衝區搜尋列

工作區

專案面板

專案搜尋列

終端機

輔助編輯器