PyCharm 2025.3 Help

在 PyCharm 中使用 Vim 编辑器 (IdeaVim)

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

安装 IdeaVim 插件

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

  2. 市场 中找到 IdeaVim 插件,然后点击 安装

  3. 重启 PyCharm。

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

配置快捷键

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

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

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

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

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

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

编辑模式

在 Vim 中,处于 普通模式 时,插入符为块状:

Vim 普通模式

要切换到 插入模式 ,请按 i ,光标将变为线状:

Vim 插入模式

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

要返回普通模式,请按 Escape

Vim 配置

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

创建 .ideavimrc 文件

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

    在小部件中创建 .ideavimrc 文件

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

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

%HOMEPATH%\_ideavimrc

~/.ideavimrc

~/.ideavimrc

如果配置已存在

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

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

    source ~/.vimrc

    通过这种方式,您还可以在 ideavimrc 文件中包含其他命令,这些命令仅应用于 PyCharm 中的 Vim,而不会影响实际的 Vim 配置。

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

  • 如果您不希望与实际的 Vim 配置相比修改 PyCharm 中的 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年 12月 2日