WebStorm 2025.2 Help

在 WebStorm 中使用 Vim

IdeaVim 是 WebStorm 编辑器的 Vim 引擎。 它支持普通、插入和可视模式,命令行和 Ex 模式、Vim 正则表达式与配置,以及其他功能。

安装 IdeaVim 插件

  1. 设置 对话框(Ctrl+Alt+S )中,选择 插件

  2. 市场 中找到 IdeaVim 插件并点击 安装

  3. 重启 WebStorm。

重启 WebStorm 后,Vim 将启用,编辑器将开始以 Vim 模式运行。 要禁用该功能,请在主菜单中取消选择 工具 | Vim

配置快捷键

Vim 和 WebStorm 都是以键盘为中心的。 WebStorm 中的键位映射可能会与 Vim 的键位组合冲突。 为不同操作选择偏好的快捷键,以解决此问题。

  1. Ctrl+Alt+S 打开设置,然后选择 编辑器 | Vim

  2. 找到快捷键及其对应的 IDE 操作,并选择在使用 Vim 时如何处理它:

    Vim 设置
    • 未定义 :显示弹出通知,建议重新定义 IDE 快捷键或在设置中配置处理方式。

      快捷键通知
    • IDE :执行与该快捷键相关联的 IDE 操作。

    • Vim :将其作为 Vim 快捷键处理。

编辑模式

Normal mode 下,Vim 中的插入点显示为块状:

Vim 普通模式

要切换到 Insert mode ,请按 i ,插入点将变为线条:

Vim 插入模式

在此模式下,您可以输入新代码或更改现有代码。 您还可以进入其他 Vim 模式:例如,按 R 进入 Replace mode

要返回 Normal mode,请按 Escape

Vim 配置

Vim 使用 vimrc 文件进行配置。 同样, IdeaVim 插件使用语法相同的 ideavimrc 文件。

创建 .ideavimrc 文件

  • 在 IDE 窗口底部的状态栏中,点击 IdeaVim 小部件并选择 创建 ~/.ideavimrc

    在小部件中创建 .ideavimrc 文件

    WebStorm 会创建该文件并在编辑器中打开。 稍后,您可以使用此小部件快速访问 ideavimrc 文件。

配置文件将根据操作系统创建在以下位置之一:

%HOMEPATH%\_ideavimrc

~/.ideavimrc

~/.ideavimrc

如果已存在配置

如果已拥有包含配置的 vimrc 文件,可以执行以下操作之一:

  • 使用 source 命令在 ideavimrc 文件中引入来自 vimrc 的配置:

    source ~/.vimrc

    通过这种方式,您还可以在 ideavimrc 文件中引入其他命令,这些命令仅适用于 WebStorm 中的 Vim,不会影响实际 Vim 配置。

  • 如果不想使用 Vim 配置,您可以将 .vimrc 重命名为 .ideavimrc

  • 如果不想让 WebStorm 中的 Vim 配置与实际 Vim 配置有所不同,则可将 ideavimrc 创建为指向 vimrc 的符号链接:

    mklink _ideavimrc _vimrc
    ln -s "$HOME/.vimrc" "$HOME/.ideavimrc"
    ln -s "$HOME/.vimrc" "$HOME/.ideavimrc"

IDE 操作

IdeaVim 允许您使用操作 ID 映射 IDE 功能。

获取操作 ID

  1. Ctrl+Shift+A 并键入 IdeaVim: Track Action Ids

  2. 使用右侧切换按钮开启该功能。

    启用 Track Action Ids 功能

    IDE 将在屏幕底部的弹出通知和 通知 工具窗口中显示您使用鼠标点击的操作 ID。 请注意,某些操作没有 ID。

    显示操作 ID
  3. 点击 复制操作 ID 可复制 ID,或点击 停止跟踪 以禁用跟踪模式。

在 ideavimrc 中映射操作

  1. ideavimrc 文件中,使用 map 命令和 <Action> 关键字映射操作,例如: map \r <Action>(ReformatCode)

  2. Ctrl+Shift+O 以重新加载更改。

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