PhpStorm 2025.2 Help

将 PhpStorm 用作 Vim 编辑器

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

安装 IdeaVim 插件

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

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

  3. 重启 PhpStorm。

重启 PhpStorm 后,Vim 被启用,编辑器开始在 Vim 模式下运行。 若要禁用它,请在主菜单中取消选择 工具|Vim

配置快捷键

Vim 和 PhpStorm 都是以键盘为中心的。 您的 PhpStorm 中的键映射可能与 Vim 的组合键冲突。 要解决此问题,请选择您喜欢用于不同操作的快捷方式。

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

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

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

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

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

编辑模式

用 Vim 时,光标在 Normal mode中是一个块:

Vim Normal 模式

要切换到 Insert mode ,请按 i ,然后光标会变成一条线:

Vim 插入模式

在此模式下,您可以编写新代码或修改现有代码。 您还可以进入其他 Vim 模式:例如,按 R 切换到 替换模式

要返回到正常模式,请按 Escape

Vim 配置

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

创建一个 .ideavimrc 文件

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

    在组件中创建 .ideavimrc 文件

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

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

%HOMEPATH%\_ideavimrc

~/.ideavimrc

~/.ideavimrc

如果配置已存在

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

  • 在您的 ideavimrc 文件中使用 source 命令包含来自 vimrc 的配置:

    source ~/.vimrc

    这样,您还可以在 ideavimrc 文件中包含其他命令,这些命令将仅应用于 PhpStorm 中的 Vim,而不会影响实际的 Vim 配置。

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

  • 如果您不想修改 PhpStorm 中的 Vim 配置,可以创建 ideavimrc 作为 vimrc 的符号链接:

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

IDE 操作

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

了解操作 ID

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

  2. 使用右侧的切换开关启用该功能。

    启用 Track Action Ids 功能

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

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

在 ideavimrc 中映射一个 action

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

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

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