Comate 提供了多行代码补全能力，但需要先手动启用 multiline 模式。开启后，您可以使用 Tab 键一次性插入带有自动缩进的整段代码，或者通过 ⌘+↓ / Ctrl+↓ 逐行采纳。ESC 可取消补全，Ctrl+Z / ⌘+Z 则能撤销整段插入——这些操作看似简单，实际使用时有一些容易忽略的细节值得留意。

为何需要多行补全？最常见的场景是编写函数体、循环结构或条件分支。此时如果逐行手动敲入，不仅要反复调整缩进，还容易因语句不连续而打断思路。多行补全的本质是将一个“逻辑单元”整体插入，缩进自动对齐，大幅提升编写效率。

用 Tab 键直接采纳全部多行补全

当光标停留在触发多行补全的位置——例如输入 if True: 后换行，或者函数定义末尾的 { 或 : 之后——Comate 会自动弹出一个带缩进的多行建议框。确认内容无误后，直接按 Tab 键，整段代码就会插入，缩进自动匹配上下文，无需手动调整。

不过这里有一个易错点：如果当前行已经存在非空白字符，比如刚写了 print( 但未闭合括号，Comate 可能会降级为单行补全，不会弹出多行建议。因此，建议让光标处于空行或仅有一个冒号/大括号的位置，以确保触发多行补全。

用 ⌘+↓（Mac）或 Ctrl+↓（Windows/Linux）逐行采纳

方式一：按住 ⌘ + ↓（Mac）或 Ctrl + ↓（Windows/Linux），每按一次插入一行，光标自动跳到下一行开头，继续按可逐步展开剩余行。这种方式适合只想部分采纳的情况，例如补全了四行，但仅需前两行。

方式二：如果补全框已展开但尚未采纳，可将鼠标移入建议框，用方向键上下选择某一行，然后按 Enter 单独采纳该行——注意此操作仅限于 VS Code 插件版，IntelliJ 系列不支持这种交互方式。

【关键前提：必须先开启“多行补全”功能】 在 VS Code 中打开设置（Ctrl+,），搜索 comate.suggestionMode，将值设为 multiline。若设为 auto，则只会在明确的语法节点（如 for、def、if 后面）激活多行逻辑，其他场景可能仍为单行补全。

取消多行补全的三种时机

第一种：补全框刚弹出，尚未进行任何操作——按 ESC 直接关闭，不会留下任何痕迹。

第二种：已经部分采纳，例如用 ⌘+↓ 插入了前两行——此时再按 ESC 可中断后续行的插入，但已插入的两行会保留下来。这听起来有些特别，但实际场景中经常遇到：补全内容前半部分正确，后半部分需要调整，此时用 ESC 打断比全部删除再重来更高效。

第三种：补全内容已全部插入，但发现错误——不要手动删除或修改缩进，那样容易破坏代码结构。直接按 Ctrl+Z（Windows/Linux）或 ⌘+Z（Mac）撤销整段补全，然后重新触发。撤销操作是原子性的，可一次性回退到补全前的状态。