【Neovim】爆速で起動するIDE構築の手引き【令和最新版】

本記事はVim駅伝の6/20の投稿です。
前回の記事はtoyboot4eさんによるZenn Book = One Org Fileでした。

TL;DR

NeovimでIDEのような機能を使えるようにカスタマイズするハンズオンです。中級者〜熟練者の方は起動画面だけでも見ていってください。

はじめに

みなさん、Neovim使っていますか？

最近X(旧Twitter)を見ていると、新たにNeovimを試したり、v0.11から新しくなったLSPの設定方法を共有したりと活発なポストが散見され、同志としては嬉しい限りです。
しかし、中には「VSCodeのような体験を再現するのが難しい！」「頑張って環境構築したけど、起動速度が芳しくない…」という方も少なくないのでは？

今回はそんなNeovim初心者さんに向けて、私が作成した爆速スターターキットSnaxVim を使ったNeovimのIDE化をやっていきたいと思います。

🔗 リポジトリ: https://github.com/SnaxVim/SnaxVim

SnaxVimの製作の経緯については、既にこちら(外部リンク)で言及しています。なぜ今になってDistro^[1]の製作を？と興味を持たれた方はぜひご参照ください。

本記事の主な目的

• 設定ファイルをNeovim上で編集することで、基本的な操作に慣れる
• Pythonを教材として、Neovim上でエラーチェック、自動整形、デバッグといったIDE的な機能を有効化する
• Neovimのプラグインを探し、追加できるようになる

対象読者

• Neovimに初めて入門される方
• 以前まで使っていた設定ファイルが壊れてしまった方
• 爆速で起動するIDEがほしい方

本記事を読んでも分からないこと

• SnaxVimにおける、Neovimの爆速起動に寄与する技術的な方法^[2]

環境構築

想定環境は厄介事の多い皆大好きWindowsです。Linux/macOSの方は適宜読み替えてください。

パッケージマネージャのインストール

はじめに、Scoop(パッケージマネージャ)をインストールしましょう。これにより、scoop install XXXと入力するだけで面倒なインストールやパスの解決をよしなにしてくれます。
Scoop自体のインストール手順については、こちら(外部リンク)をご参照ください。

必須パッケージの追加

• neovim
• git
• llvm^[3]

事前にScoopをインストールしている場合、以下のように入力することでインストールできます。

scoop install neovim

Neovimがインストールできたら、バージョンを確認してください。2025年6月現在、SnaxVimはNVIM v0.11.0以上をサポートしています。

nvim -v

NVIM v0.11.2
Build type: Release
LuaJIT 2.1.1741730670
Run "nvim -V1 -v" for more info

上記のように表示された場合は問題ありません。

SnaxVimの準備

過去にNeovimを使ったことがある場合の追加操作

設定ファイルが残っている場合、以下のようにリネームして退避しておきましょう。

move %LOCALAPPDATA%/nvim %LOCALAPPDATA%/nvim-bak
move %LOCALAPPDATA%/nvim-data %LOCALAPPDATA%/nvim-bak-data
move %TMP%/nvim %TMP%/nvim-bak

1. リポジトリをC:Users\（ユーザ名）\AppData\Local\nvimにクローンします。

git clone https://github.com/SnaxVim/SnaxVim %LOCALAPPDATA%/nvim

上記ディレクトリにファイルを置きたくない場合、適当な場所に落としてからシンボリックリンクを貼ってください。

2. リモートブランチを削除/リネームします。

git remote remove origin

NeovimはTUIなので、アイコンの表示にはNerd Fontsが必要になります。
導入せずとも文字化けが発生する程度のため動作上の問題は全くありませんが、気になる方はご自身のターミナルのフォントをHackGen_NF等のNerd Fontsに対応したものに変更してください。

NeovimのIDE化(LSP, DAP, Linter, Formatterの有効化)

Neovim上での操作に慣れるため、以降の手順はなるべく他のエディタ等を使わずに実施してください。

前準備は完了です。さあ、Neovimを起動しましょう！

nvim

Neovimが起動すると、まずlazy.nvimというプラグインマネージャが発火します。
いくつかのプラグインが自動的にC:Users\（ユーザ名）\AppData\Local\nvim-data\lazyにクローンされるので、しばらく待機します。

lazy.nvimによるプラグインのインストールが正常に終了したら、早速IDE化していきましょう。

今回扱う言語はPythonとLua(Neovimの設定ファイルに使用)です。ご自身のPythonのパスを通すのをお忘れなく。

LSPの設定

SnaxVimは、設定ファイルの内容をもとに必要なパッケージを自動インストールします。
まずは、LSPを設定してエラーチェックやコード補完を有効化するところから始めましょう。

起動後の画面はこのようになっています。指示に従ってcを押下後、lua\configs\nvim-lspconfig.luaと検索しEnterキーを押下します。

すると、以下のようなテキストが表示されます。コメントの通り、serversテーブル内のアイテムをアンコメントしましょう。
jで下へ、kで上へカーソルを移動し、カーソル列が合わせられたらgccと入力することで、アンコメント/コメントアウトを切り替えられます。

同様に、-- Override the default...以降のコメントもアンコメントします。すぐ下の列にカーソルを合わせ、Vで行選択モードに入り、j/kで特定の範囲を選択できます。
対象範囲まで範囲選択できたら、gcと入力することで、選択した範囲のアンコメント/コメントアウトを切り替えられます。
ここまでできたら、:upと入力後にEnterキーを押下して変更を保存しましょう。

その後:qと入力後にEnterキーを押下することでNeovimを終了できます。

途中でInsertモード等の異なるモードに入ってしまった場合、Escキーを押下することでNormalモードに復帰できます。
意図しない文字が入力された場合はNormalモード時にu/Ctrl+rを入力して元に戻す/やり直しができますが、あまりに収拾がつかなくなってしまった場合は:qa!と入力後にEnterキーを押下してください。変更を破棄してNeovimを終了できます。

これまでに登場したモーションをまとめます。

モード	キー操作	意味
Normal	j	下へ
Normal	k	上へ
Normal	gcc	コメントアウト / アンコメント
Visual	gc	コメントアウト / アンコメント
Normal	V	モード変更: 行選択
Normal以外	Esc	モード変更: Normal
Normal	u	アンドゥ
Normal	Ctrl+r	リドゥ
Normal	:up Enter	変更を保存
Normal	:q Enter	アクティブなバッファを終了
Normal	:qa! Enter	すべてのバッファを終了(変更を破棄)

LSPのインストール

次に、mason.nvim経由で先ほど設定したLSPをインストールします。:Masonと入力後にEnterキーを押下してください。

インストールが自動的に開始するため、特に何も触らずにしばらく待ちます。

インストールが完了したら、qでMasonのウィンドウを閉じましょう。

basedpyrightはPythonを要するため、ターミナルからPythonを起動できない場合はインストールが失敗します。パスを正しく通してからmason.nvimを起動してください。

LSPの動作確認

:ed test.pyと入力後にEnterキーを押下して、新規Pythonファイルを編集してみましょう。
例として、iでInsertモードに入り、foo=と入力してEscキーを押下します。

basedpyrightが正常に起動している場合、上記のように怒られるはずです。
正常な挙動が確認できたら、:q!と入力後にEnterキーを押下することで、ファイルを保存せずにNeovimを終了してください。

新たに登場したモーションをまとめます。

モード	キー操作	意味
Normal	i	モード変更: Insert
Normal	:ed (ファイルパス) Enter	指定したディレクトリのファイルを開く
Normal	:q! Enter	アクティブなバッファを終了(変更を破棄)

DAP, Linter, Formatterのインストール

同様にして、起動画面に記載の設定ファイル^[4]をそれぞれ開き、指示に従って適切なアイテムをアンコメントします。
その後、Neovimを再起動してmason.nvimを開くことで、同様に自動インストールが始まります。

プラグインの追加による機能拡張

Neovimには様々な方が作成したプラグインが多数存在します。今回は、デバッグ環境の構築を例に、プラグインのインストールとその活用の方法について解説します。

プラグインの探し方

Neovimには、VSCodeにおけるMarketplaceのようなものが存在しません。現状は有志が作成したリストを参照するか、自ら情報収集するしかないようです。

なお、有名なものとしては以下が挙げられます。

• my-neovim-pluginlist
• Awesome Neovim
• Dotfyle
• neovimcraft

Python用デバッグ環境の構築(nvim-dap-pythonのインストール)

Neovimの初回起動時に自動的に導入されたnvim-dapはDAP用のクライアントですが、各言語に応じた設定はユーザ側で書く必要があります。
nvim-dap-xxx という名前のプラグインは設定のベストプラクティスを提供してくれるため、特にこだわりがない場合はそれらを頼りましょう。

Neovimの起動後、先ほどと同様にcを押下し、lua\plugins\example.luaを開いてください。

nvim-dap-pythonについて記載しているブロックを範囲選択・アンコメントし、保存してNeovimを再起動します。

Neovimの起動時、lazy.nvimが発火してnvim-dap-pythonが新たに追加されます。

SnaxVimでは、lua\pluginsディレクトリ内のファイルには追加するプラグインのリストとその起動条件のみを記入することを推奨しています。
各プラグインの設定はlua\configsに、キーマップはlua\keymapsに配置しましょう。具体的な書き方については、lua\plugins\init.luaやlua\keymaps\init.luaを参考にしてください。

デバッガの動作確認

SnaxVimでは、デバッグ用のキーマップが事前に用意されています。
Neovimを起動しmを押下後、"debug"と検索するとデバッグ関連のキーマップ一覧が表示されます。なお、一覧表示の際にプレビューウィンドウが邪魔な場合はAlt+pを押下してください。

先ほどと同様に、:ed fibo.pyと入力後にEnterキーを押下することで、新規のpythonファイルを開きます。
内容はこんな感じで良いでしょう。入力しながらPython用のコード補間が正常に動作することを確認してください。

fibo.py

def fibonacci(n: int, curr: int = 1, prev: int = 0) -> int:
    if n == 0 or n == 1:
        return curr
    else:
        return fibonacci(n - 1, curr + prev, curr)


if __name__ == "__main__":
    val = 10
    print(f"f({val}) = {fibonacci(val)}")

上記の内容を入力し保存したら、F5キーを押下してデバッグを開始します。このとき、F9キーでブレークポイントを貼ることもできます。

なお、SnaxVimではigorlfs/nvim-dap-viewというプラグインにより、デバッグ時に専用のバッファが開きます。分割されたバッファ間を移動したい場合、Ctrl+wに続けて方向キー(h/j/k/l)を入力します^[5]。
このバッファはコードの走査が完了した際に閉じてしまいますが、F7キーを押下することで直前の出力を再表示できます。

Windowsにおいて、Mason経由でインストールしたdebugpyを利用する場合、デバッグ中に黒いウィンドウが表示されてしまうようです。
気になる場合はパスを通したPython本体にdebugpyをインストールし、lua\plugins\example.luaにおけるrequire("dap-python").setup(python)中の(python)を("python")もしくは("C:/path/to/python")のように変更してください。

新たに登場したモーションをまとめます。

モード	キー操作	意味
Normal	h	左へ
Normal	l	右へ
Normal	Ctrl+w h/j/k/l	分割されたバッファ間の移動

次にやるべきこと

これにてハンズオンは終了です。お疲れ様でした！
まだ気力が残っている方は、以下のようなことも試してみてはいかがでしょうか。

• lua\configs以下のファイルを覗いてみて、設定の構造を把握する
• 使いたい言語のLSPを追加で設定・インストールする
• 好きなプラグインを追加してみる(e.g. gitsigns.nvim, lualine.nvim)

おわりに

猫も杓子もVSCodeな昨今ですが、ターミナル内での生活も意外と悪くないということがわかっていただけたら幸いです。良きNeovimライフを！

🔗 リポジトリ: https://github.com/SnaxVim/SnaxVim
もし気に入っていただけましたら、上記リポジトリに⭐をいただけますと大変励みになります！

脚注

1. Neovim Distributionのこと。複数のプラグインや設定を組み合わせ、自身の環境にクローンするだけでNeovim上で様々な機能を使えるように調整された一連の設定ファイルを、このように呼ぶ文化がある。なお、kickstart.nvimのように自らDistroでないことを標榜するものもあり、定義には個人差があるようにも思われる。

2. あまり複雑なことはしていないので、気になる方はソースコードをご参照ください(PR大歓迎です！！)。誠にごめんなさい🙇

3. mingwでも可

4. lua\configs\nvim-dap.lua, lua\configs\nvim-lint.lua, lua\configs\conform.lua

5. プリセットではこれらのキーが割り当てられているが、SnaxVimではCtrl+方向キーで同様の動作を実現できる。