PyCharm で Vim エディターを使用する (IdeaVim)

IdeaVim は PyCharm エディター用の Vim エンジンです。通常モード、挿入モード、ビジュアルモード、コマンドラインモードと Ex モード、Vim 正規表現と構成、およびその他の機能をサポートしています。

PyCharm を再起動すると Vim が有効になり、エディターが Vim モードで動作を開始します。無効にするには、メインメニューでツール | Vim の選択を解除します。

Vim と PyCharm はどちらもキーボード中心です。 PyCharm のキーマップは Vim のキーの組み合わせと競合する場合があります。これを解決するには、さまざまなアクションに適したショートカットを選択します。

Ctrl+Alt+S を押して設定を開き、エディター | Vim を選択します。
ショートカットと対応する IDE アクションを見つけて、Vim を使用するときにどのように処理するかを選択します。
- 未定義: IDE ショートカットを再定義するか、設定でハンドラーを構成することを提案するポップアップ通知を表示します。
- IDE: このショートカットに関連付けられている IDE アクションを実行します。
- Vim: Vim ショートカットとして処理します。

編集モード

Vim では、ノーマルモード(英語)にいるとき、キャレットはブロックです。

挿入モードに変更するには、 i を押すと、カーソルが線になります：

このモードでは、新しいコードを入力したり、既存のコードを変更したりできます。他の Vim モードに入ることもできます。たとえば、 R を押して置換モードに入ります。

ノーマルモードに戻るには、 Escape を押します。

Vim は vimrc ファイルを使用して構成されます。同様に、 IdeaVim プラグインは同じ構文の ideavimrc ファイルを使用します。

IDE ウィンドウの下部にあるステータスバーで、 IdeaVim ウィジェットをクリックし、 ~/.ideavimrc を作成を選択します。
PyCharm はファイルを作成し、エディターで開きます。後でこのウィジェットを使用して、 ideavimrc ファイルにすばやくアクセスできます。

構成ファイルは、オペレーティングシステムに応じて、次のいずれかの場所に作成されます：

%HOMEPATH%\_ideavimrc

~/.ideavimrc

構成に vimrc ファイルがすでにある場合は、次のいずれかを実行できます。

ideavimrc ファイルに source コマンドを使用して、 vimrc の構成を含めます。
source ~/.vimrc
このようにして、 ideavimrc ファイルに他のコマンドを含めることもでき、これらは PyCharm の Vim にのみ適用され、実際の Vim 構成には影響しません。
Vim 構成を使用したくない場合は、 .vimrc の名前を .ideavimrc に変更できます。
実際の Vim 構成と比較して PyCharm 内の Vim を変更したくない場合は、 vimrc へのシンボリックリンクとして ideavimrc を作成してください：
mklink _ideavimrc _vimrc
ln -s "$HOME/.vimrc" "$HOME/.ideavimrc"
ln -s "$HOME/.vimrc" "$HOME/.ideavimrc"

IdeaVim では、アクション ID を使用して IDE 機能をマップできます。

Ctrl+Shift+A を押して、 IdeaVim: Track Action Ids と入力します。
右側のスイッチャーを使用して機能を切り替えます。
IDE は、マウスでクリックしたアクションの ID を画面下部のポップアップ通知と通知ツールウィンドウに表示します。一部のアクションには ID がないことに注意してください。
Copy Action Id をクリックして ID をコピーするか、追跡を停止をクリックして追跡モードを無効にします。

ideavimrc ファイルで、 map コマンドと <Action> キーワードを使ってアクションをマップします。例えば、 map \r <Action>(ReformatCode) です。
Ctrl+Shift+O を押して、変更を再ロードします。

2026 年 6 月 1 日