使用

（目前尚未完整记录，更多信息见 按键映射。）

类似于 vimtutor 的介绍见 tutor （可通过 hx --tutor 或 :tutor 访问）。

寄存器

使用类似 Vim 的寄存器 (registers) 来拖拽 (yank) 和存储文本，以便稍后粘贴。使用方法也与 Vim 类似，按 " 来选择一个寄存器：

• "ay：将当前选择拖到寄存器 a
• "op：在选择后粘贴寄存器 o 中的文本

如果在调用修改或删除文本命令之前选择了寄存器，则将选择的内容存储在寄存器中，并执行操作：

• "hc：将所选的文本存储在寄存器 h 中，然后修改所选的文本（即删除文本并进入插入模式）
• "md：将所选文本存储在寄存器 m 中，并删除所选的文本

特殊寄存器

Helix 没有用于复制到系统剪贴板的特殊寄存器，而是提供了特殊的命令和按键绑定。详细信息见 space mode。

黑洞寄存器用作无操作 (no-op) 寄存器，这意味着不会向其写入数据或从中读取数据。

环绕

类似于 vim-surround 的功能已被内置到 Helix 中。按键映射的灵感来自 vim-sandwich：

• ms：添加环绕字符，作用于选定内容，因此先选择文本，然后按 ms<char>
• mr：替换环绕字符，用于找到的最接近的配对，所以并不需要选择文本；使用计数¹作用于外层配对
• md：删除环绕字符，使用与 mr 类似

它还可以作用于多光标选择（耶！）。例如，将每次出现的 (use) 改为 [use]：

• 按 % 选择整个文件
• 再按 s 根据搜索词拆分并选中文本
• 输入 use 并按 Enter
• 按 mr([ 用方括号替换圆括号

当前不支持多个字符，但计划支持。

基于语法树移动选区

按 Alt-p、Alt-o、Alt-i 和 Alt-n（或 Alt 和四个方向键之一）可根据语法树的位置来移动选择区域。

让我们通过一个示例来熟悉它们。许多语言对于函数调用都有类似这样的语法：

func(arg1, arg2, arg3)

函数调用可能会被 tree-sitter 解析为如下语法树：

(call
  function: (identifier) ; func
  arguments:
    (arguments           ; (arg1, arg2, arg3)
      (identifier)       ; arg1
      (identifier)       ; arg2
      (identifier)))     ; arg3

使用 :tree-sitter-subtree 查看所选的语法树。用更直观的树形结构表示成：

            ┌────┐
            │call│
      ┌─────┴────┴─────┐
      │                │
┌─────▼────┐      ┌────▼────┐
│identifier│      │arguments│
│  "func"  │ ┌────┴───┬─────┴───┐
└──────────┘ │        │         │
             │        │         │
   ┌─────────▼┐  ┌────▼─────┐  ┌▼─────────┐
   │identifier│  │identifier│  │identifier│
   │  "arg1"  │  │  "arg2"  │  │  "arg3"  │
   └──────────┘  └──────────┘  └──────────┘

假设我们光标放在 arg1 上，那么就选择了上面树中的 arg1 叶节点上（方括号表示选区）：

func([arg1], arg2, arg3)

按 Alt-n （或者 Alt-→） 将选择语法树中的下一个同级 (sibling) arg2：

func(arg1, [arg2], arg3)

而按 Alt-o （或 Alt-↑） 会将选择扩展到父节点。在上面的树中，我们将选择 arguments 节点。

func[(arg1, arg2, arg3)]

还有一些细微差别的行为可以防止你停留在没有同级节点的节点上。如果选择 arg1，那么按 Alt-p （或 Alt-←） 将移动到上一个子节点。但是，由于 arg1 在其左侧没有同级项，所以往语法树父级走，然后选择前一个的节点。因此，Alt-p 最终把选区移到 func 这个标识符上。

[func](arg1, arg2, arg3)

文本对象

上面的演示分别使用以下按键来选择文本对象 (textobject)：

• ma 在对象周围选择 （Vim 中为 va，Kakoune 中为 <alt-a>）
• mi 在对象内部选择 （Vim 中为 vi，Kakoune 中为 <alt-i>）

注意：f、c 等功能需要当前文档的 tree-sitter 语法和特殊的 tree-sitter 查询文件才能正常工作。目前只有 一些语法 有查询文件。欢迎贡献！

基于文本对象的导航

通过 tree-sitter 和文本对象查询，可以在函数、类、参数等之间导航。

例如，使用 ]f 移动到下一个函数，使用 [c 移动到上一个类，等等。

对此的完整信息请参考 unimpaired。

注意：此功能依赖于 tree-sitter 的文本对象，因此需要相应的查询文件才能正常工作。