https://tro3373.github.io/tags/neovim/ Recent content in neovim on tac lifelog https://tro3373.github.io/favicon.png https://tro3373.github.io/favicon.png Hugo ja Thu, 12 Nov 2026 13:46:34 +0900 https://tro3373.github.io/posts/2026/2026-11-12-lazy-nvim-lazy-load-pitfalls/ Thu, 12 Nov 2026 13:46:34 +0900 https://tro3373.github.io/posts/2026/2026-11-12-lazy-nvim-lazy-load-pitfalls/ <h2 id="結論">結論</h2> <ul> <li>lazy.nvim の遅延ロードは、spec (プラグインごとに書く設定の表) に書いたきっかけが来るまでプラグインを読まない。きっかけが来ない起動の仕方では一度も読まれず、エラーも出ない</li> <li><code>event = { &quot;BufReadPost&quot;, &quot;BufNewFile&quot; }</code> で遅延したプラグインは、引数なしで起動すると読まれない。起動直後から要る statusline などは <code>lazy = false</code> か <code>event = &quot;VeryLazy&quot;</code> にする</li> <li>プラグインが読まれる前にそのバッファの FileType が済んでいると、FileType はやり直されない。<code>nvim a.md</code> では a.md の FileType が BufEnter より先に済むので、<code>event = &quot;BufEnter&quot;</code> と <code>event = &quot;VeryLazy&quot;</code> で読むプラグインは、a.md に ftplugin も FileType の autocmd も効かない。<code>:edit a.md</code> で開けば効き、<code>ft = &quot;markdown&quot;</code> と <code>event = &quot;BufReadPost&quot;</code> なら <code>nvim a.md</code> でも効く</li> <li><code>cmd = &quot;Tool&quot;</code> で起動時に用意されるのは <code>:Tool</code> だけで、<code>:ToolInstall</code> のような他のコマンドと <code>plugin/*.vim</code> が張るキーマップは、<code>:Tool</code> を打って読まれるまで無い</li> <li><code>nvim --headless</code> では UIEnter が来ないので、<code>VeryLazy</code> のプラグインは読まれない。<code>-c 'qa!'</code> は VimEnter より前に終わる。headless で読まれないことは、UI を attach した起動で壊れている証拠にならない</li> </ul> <p>以下は Neovim 0.12.5 と lazy.nvim v11.17.5 (の 4 commit 後、306a055) で確かめた。プラグインは、ローカルのディレクトリを spec の <code>dir</code> で読ませた最小のものである。「実 UI」は、<code>script</code> コマンドが作る疑似端末 (pty) の中で nvim を画面付きで起動し、起動 300ms 後の状態を記録した結果である。</p>