https://ha.gizwoo.com/tags/neovim/Recent content in Neovim on hagizo.ioHugo -- gohugo.ioenWed, 20 May 2026 20:31:12 +0900https://ha.gizwoo.com/neovim-keymap-setup-qw7plm3xzn/Thu, 23 Apr 2026 09:30:00 +0900https://ha.gizwoo.com/neovim-keymap-setup-qw7plm3xzn/<p>Neovim環境は、エディタ単体ではなく「ターミナル」「ファイル操作」「キーマップ設計」まで含めて整えると使いやすくなる。特に毎日触る操作は、コマンド入力よりもキー操作に寄せることで、作業の流れを止めにくくなる。</p> <h2 id="全体方針">全体方針 </h2><p>最初から完成形を目指すよりも、日々の操作を少しずつ改善していく方が長続きしやすい。</p> <table> <thead> <tr> <th>項目</th> <th>採用しているもの</th> <th>理由</th> </tr> </thead> <tbody> <tr> <td>ターミナル</td> <td>WezTerm</td> <td>Luaで設定でき、Neovim設定との親和性が高い</td> </tr> <tr> <td>ファイルエクスプローラ</td> <td>neo-tree.nvim</td> <td>ファイルだけでなく、バッファ一覧も扱いやすい</td> </tr> <tr> <td>ショートカット設計</td> <td><code>;</code> / <code>;;</code> プレフィックス</td> <td>1文字キーの枯渇を避けつつ、体系化しやすい</td> </tr> <tr> <td>キーガイド</td> <td>which-key.nvim</td> <td>入力途中で次の候補を確認できる</td> </tr> </tbody> </table> <h2 id="weztermを使う理由">WezTermを使う理由 </h2><p>WezTermは設定ファイルをLuaで書けるターミナル。Neovimの設定もLuaで書く場合、ターミナル側もLuaで管理できるのは大きな利点になる。フォント、配色、キーバインド、タブ、ペインなどをコードとして扱えるため、dotfilesで管理しやすい。</p> <p>ターミナルとエディタの設定言語が揃うことで、環境全体を一つの開発基盤として扱える。</p> <h2 id="ファイル操作はneo-treenvim">ファイル操作はneo-tree.nvim </h2><p>ファイルエクスプローラにはneo-tree.nvimを使っている。neo-tree.nvimは filesystem、buffers、git_status などを扱える。特に便利なのは、開いているバッファ一覧を表示できる点。</p> <p>ファイルツリーだけでは「今どのファイルを開いているか」が見えにくいことがある。バッファ一覧をサイドバーで確認できると、作業中の文脈を保ったまま移動しやすい。</p> <h2 id="キーマップ設計">キーマップ設計 </h2><p>Neovimでは、よく使う操作をUserCommandにする方法と、キーマップに割り当てる方法がある。頻繁に使う操作は、コマンド入力よりキーマップ化した方が速い。毎回 <code>:CommandName</code> と入力するより、キー入力だけで実行できる方が作業の流れを止めにくい。</p> <h3 id="-と--を使う"><code>;</code> と <code>;;</code> を使う </h3><p>1文字のアルファベットキーだけでショートカットを作ると、すぐに割り当て先が足りなくなる。そこで、<code>;</code> や <code>;;</code> をプレフィックスとして使う。</p> <table> <thead> <tr> <th>キー</th> <th>用途</th> </tr> </thead> <tbody> <tr> <td><code>;</code></td> <td>よく使う一等地の操作</td> </tr> <tr> <td><code>;;g</code></td> <td>Git系メニュー</td> </tr> <tr> <td><code>;;f</code></td> <td>ファイル系メニュー</td> </tr> <tr> <td><code>;;b</code></td> <td>バッファ系メニュー</td> </tr> <tr> <td><code>;;l</code></td> <td>LSP系メニュー</td> </tr> </tbody> </table> <p>Git系であれば、次のように整理できる。</p> <table> <thead> <tr> <th>キー</th> <th>操作例</th> </tr> </thead> <tbody> <tr> <td><code>;;ga</code></td> <td>git add</td> </tr> <tr> <td><code>;;gp</code></td> <td>git push</td> </tr> <tr> <td><code>;;gs</code></td> <td>git status</td> </tr> </tbody> </table> <p>プレフィックスで分類しておくと、キーマップが増えても破綻しにくい。</p> <h2 id="which-keynvimで補助する">which-key.nvimで補助する </h2><p>キーマップを増やすと、次に問題になるのは「何を割り当てたか忘れる」こと。which-key.nvimは、キー入力の途中で利用可能なキーバインド候補をポップアップ表示するNeovimプラグイン。</p> <p>たとえば <code>;;g</code> まで入力した時点でGit系の候補が表示されれば、次に <code>a</code>、<code>p</code>、<code>s</code> のどれを押せばよいか確認できる。各キーマップに <code>desc</code> を付けておくと、which-key.nvimで表示される説明も管理しやすい。</p> <h2 id="まとめ">まとめ </h2><p>Neovim環境は、プラグインを大量に入れるよりも、よく使う操作を迷わず実行できる状態にすることが重要。</p> <table> <thead> <tr> <th>方針</th> <th>内容</th> </tr> </thead> <tbody> <tr> <td>ターミナル</td> <td>WezTermでLua設定に寄せる</td> </tr> <tr> <td>ファイル操作</td> <td>neo-tree.nvimでファイルとバッファを扱う</td> </tr> <tr> <td>操作体系</td> <td><code>;</code> / <code>;;</code> プレフィックスで分類する</td> </tr> <tr> <td>補助</td> <td>which-key.nvimで候補を表示する</td> </tr> </tbody> </table> <p>日々の「少し面倒」をキーマップにしていくと、Neovim環境は自然に育っていく。最初から完璧な設定を作るより、自分の操作に合わせて少しずつ拡張する方が実用的。</p>