WebStorm 2025.2 Help

多个光标和选择范围

在 WebStorm 编辑器中输入、复制或粘贴时,您可以切换多个光标,使您的操作同时作用于多个位置。 编辑器内的高级操作,例如 代码补全实时模板 也同样受支持,并会应用于每个光标。

单个文件中最多可添加 1000 个光标。 如果希望提高该限制,请打开 custom JVM options帮助 | 编辑自定义 VM 选项 ,然后添加以下行: -Deditor.max.caret.count=<NEW_LIMIT>

最近添加的光标被视为 主光标。 当前编辑行的高亮显示、补全列表以及其他视觉辅助功能将应用于主光标。 关闭多个光标后,该光标仍将保留。

添加和移除光标

光标可添加到代码行中的两个位置:

已有字符处

使用虚拟空格

如果您想要添加光标的位置没有字符、Tab 或空格,新光标将添加到目标行的最后一个字符位置。

这样,您可以在任意行的最后一个字符之后添加新光标。 从行尾开始的位置开始输入时,将会在行尾与输入开始处之间自动插入相应数量的空格。

您可以通过在 编辑器 | 常规 设置页面中勾选 允许插入插入符于行尾之后 来启用虚拟空格 Ctrl+Alt+S。 或者,也可以在 列选择模式 中启用虚拟空格。

使用鼠标在选定位置添加或移除光标

  • 在目标位置 Alt+Click 添加另一个光标。

    使用鼠标添加多个光标
  • 在某个已有光标处 Alt+Click 移除该光标。 最后一个光标不会被移除。

使用键盘在当前光标上方或下方添加光标

  • Ctrl 两次,然后在不松开的情况下按向上或向下箭头键。

    如果启用了 虚拟空格 ,那么新光标会精确地添加到当前光标上方或下方的位置。 否则,在比当前偏移位置短的行中,光标将被添加到行尾。

  • 启用 列选择模式 (按 Alt+Shift+Insert ),然后按 Shift+Up/Shift+Down

  • Ctrl+Shift+A ,输入 克隆光标 ,然后从建议列表中选择所需的操作。

    克隆光标

在当前文档的每一行添加光标

  • Ctrl+Home 将光标定位到第一行开头,启用 列选择模式 (按 Alt+Shift+Insert ),然后按 Ctrl+Shift+End

在选定代码块的每一行末尾添加光标

  • 在编辑器中选择一个代码块,然后按 Alt+Shift+G 或通过主菜单进入 编辑 | 将插入符添加到所选行末尾

移除多个光标

  • Esc 删除除最后一个光标以外的所有光标。

  • 在某个已有光标处 Alt+Click 移除该光标。 最后一个光标不会被移除。

选择多个非连续范围

当您选择多个文本范围(非连续选择)时,请注意以下事项:

  • 每个选择范围都有其自己的光标,因此您可以直接输入以替换所有选定范围的内容,或者按 Left Arrow Right Arrow 移除选择范围,但保留光标在原先范围的起点或终点。

  • 一旦选择范围重叠,它们将合并为一个单一的选择范围并共享一个光标。

  • 选择操作不依赖于代码结构。 也就是说,选择范围可以包含任意字符、标识符、字符串文字、注释中的单词或其部分内容。 因此在修改选定范围时请小心,因为它们可能包含不同的标识符或其部分内容。

选择多个单词或文本范围

  • Alt+Click 会添加一个新光标,双击单词或拖动鼠标选择文本范围(保持按键不松)将会添加带有相应选择范围的新光标。

    WebStorm:选择多个文本片段.png

选择单词或文本范围的多个出现位置

  1. 如果想要选择单词,请将光标置于目标单词的出现处。 否则,请使用鼠标或 键盘快捷键 选择所需范围。

  2. 请执行以下任一操作:

    • 连续按下 Alt+J ,查找并选择下一个大小写匹配的单词或文本范围。

    • 按下 Ctrl+Alt+Shift+J ,选择文档中所有大小写匹配的单词或文本范围。

  3. 要取消最后一次选择的内容,请按 Alt+Shift+J

  4. 使用 Alt+J 添加第二个或后续选择内容之后,您可以跳过该选择并通过 F3 选择下一个匹配项。 要将选择返回至最后跳过的匹配项,请按 Shift+F3

查找并选择字符串的多个出现位置

  1. 按下 Ctrl+F ,或从主菜单中选择 编辑 | 查找 | 查找。 搜索窗格将显示在活动编辑器的顶部。

  2. 输入要查找并选择的字符串。 在搜索字符串的右侧,您将看到当前文档中出现的次数。

  3. 您还可以选择按大小写 区分大小写 Alt+C 或仅匹配整个单词 单词 Alt+W 来限制搜索范围。

  4. 按下 Ctrl+Alt+Shift+J ,或单击工具栏中的 选择所有匹配项 选择所有出现位置

在普通选择模式中使用鼠标选中矩形文本片段

  1. 请确保 列选择模式 已禁用

  2. 如需将范围选择为一个矩形,请执行以下任一操作:

    • 将插入符放置在矩形的一角,然后在对角处按下 Alt+Shift+Middle-Click

    • 按住 Alt+Click 并拖动鼠标以进行选择。

  3. 如需将范围选择为多个矩形,请按住 Ctrl+Alt+Shift+Click 并拖动鼠标覆盖所需的代码部分。

  4. 结果是在每个受影响的文档行中将存在多个选择范围。 在长度短于矩形的行上,选择范围仅会扩展到最后一个字符。

    WebStorm:使用鼠标选择多个矩形文本片段

列选择模式

在普通模式与列选择模式之间切换

  • 按下 Alt+Shift+Insert

  • 在主菜单中,前往 编辑 | 列选择模式

  • 在编辑器的右键菜单中,选择 列选择模式

列选择模式下,为方便添加多个插入符和执行矩形选择,当前文档中的键盘导航及选择快捷键的行为会有所不同:

  • 您可以将插入符放置在任何一行最后字符之后的任意位置。 当您开始在行尾之后的位置键入内容时,将在行尾和输入起始位置之间插入必要数量的空格。

  • 按下 Shift+Up/Shift+Down 或上下拖动鼠标,将在当前插入符的上方或下方添加新的插入符,而不会创建连续选择。

  • 启用的列选择模式仅影响当前编辑器选项卡。 如果关闭或重新打开该选项卡,将会恢复为普通模式。

如果当前文档启用了列选择模式, 指示器将显示在 状态栏中。

列模式

使用多个光标进行复制与粘贴

当使用多个插入符选择的文本范围被复制 Ctrl+C 或剪切 Ctrl+X 时,每个插入符对应的选择内容将作为单独的行放入剪贴板,即使原始选择内容在同一行上。

如果启用了 列选择模式 ,选择内容也可能包含行尾之后的空白区域。 如果复制选择内容,这些区域将在剪贴板中替换为空格。

从剪贴板粘贴多行内容时,您可以在所需位置为每一行添加多个插入符,然后按下 Ctrl+V ,即可将每一行粘贴到对应的插入符位置。

最后修改日期: 2025年 9月 26日