2026年11月のNeovim設定見直し:Markdown折り返し・プラグイン整理と隠れていた不具合の修正

Neovimの設定を少しずつ足し続けていたところ、いつの間にか重複した記述や古い設定が溜まっていました。さらに困っていたのがMarkdownの編集画面です。以前は長い表が折り返されて崩れるのを嫌って wrap = false にしていましたが、普段の文章まで画面外へ大きくはみ出すようになり、かえって読みづらくなっていました。

そこで2026年11月15日に、Markdownの折り返し復活とプラグイン構成の見直しを実施しました。その後11月19日に、現在のNeovim 0.12.1・LazyVim v16.0.2の本体コードと照らし合わせて ~/.config/nvim 全体を再点検したところ、nvim-lint・nvim-dap・lualine・blink.cmp まわりで想定どおり動いていなかった隠れた不具合が次々に見つかり、これもまとめて直しています。

今回やったことの全体像

変更は大きく「Markdownの表示修正」「重複・不要設定の掃除」「プラグイン構成の入れ替え」「実装照合で見つけた不具合・負荷の修正」の4つです。

対象 変更前 変更後 変更した理由
Markdown表示 wrap = false / linebreak = false wrap = true / linebreak = true / breakindent = true 長文が画面外へはみ出しすぎて読めなかったため
Extras・不要ファイル lazyvim.json と lazy.lua で二重定義 / go.lua 等残存 lazyvim.json 一本化+yazi.lua / .neoconf.json 等削除 :LazyExtras とのズレや未使用スタブ・lock残骸をなくすため
検索Picker snacks.picker + telescope.nvim 併用 snacks.picker に一本化(<c-k> 等小文字統一) Snacks側で -t / -g と引用を賄え、重複警告も防げるため
差分レビュー sindrets/diffview.nvim esmuellert/codediff.nvim 更新停滞の回避とライブレビュー対応のため
デバッグUI rcarriga/nvim-dap-ui igorlfs/nvim-dap-view(nvim-dap の依存先に追加) 画面下のパネル1つで変数やブレークポイントを切り替えたいから
AI連携 外部CLI(Herdr)のみ folke/sidekick.nvim を併用(NES無効) 選択範囲やファイルをNeovim内からCLIへ送るため
隠れた不具合修正 nvim-lint 引数欠落 / dap.core 上書き / blink / lualine / dap_utils 本体実装に合わせて各プラグイン設定と補助スクリプトを修正 無効化されていたLint・DAP署名/JSONC・行ハイライト・パス処理を正常化するため

1. Markdownが画面外にはみ出す問題を直す(wrap = true 復活)

以前は「Markdownの長い表が画面端で折り返されると列が崩れて読みにくい」という理由で、lua/config/autocmds.lua に wrap = false と linebreak = false を入れていました。

ただ、実際にブログ原稿や設計メモを書くと、長い段落が画面右端からずっと先へ伸びてしまい、行全体を見渡せなくなりました。リンクのパスやURLを常時見せるための conceallevel = 0 は残し、折り返しを有効に戻しました。

lua/config/autocmds.lua のMarkdown用の設定を次に置き換えます。新しく開くMarkdownには FileType で適用し、設定を読み込んだ時に表示中のファイルがすでにMarkdownなら、その場でも適用します。Markdownを開き、:setlocal wrap? linebreak? breakindent? で3項目が有効になっていることを確かめます。

-- ~/.config/nvim/lua/config/autocmds.lua
local function apply_markdown_view_options()
  vim.opt_local.conceallevel = 0
  vim.opt_local.concealcursor = ""
  vim.opt_local.wrap = true
  vim.opt_local.linebreak = true
  vim.opt_local.breakindent = true
end

local markdown_view = vim.api.nvim_create_augroup("markdown_view", { clear = true })
vim.api.nvim_create_autocmd("FileType", {
  group = markdown_view,
  pattern = { "markdown", "markdown.mdx" },
  callback = apply_markdown_view_options,
})

if vim.bo.filetype == "markdown" or vim.bo.filetype == "markdown.mdx" then
  apply_markdown_view_options()
end

Markdownでwrap=falseにしていた変更前の画面。長い段落が画面右端で途切れている

Markdownでwrap=trueとlinebreak=trueを有効にした変更後の画面。段落がウィンドウ幅で折り返されている

折り返しを比べた2枚は、LazyVim v16.0.1のときの画面です。


2. 重複設定と古い残骸・無効になっていた設定を片づける

LazyVim Extras の二重インポート解消

lazyvim.json と lua/config/lazy.lua の両方に lang.python・lang.typescript・lang.json・lang.sql が書かれていました。LazyVimの :LazyExtras は lazyvim.json を正として扱うため、使っている Extras(ai.sidekick・dap.core・lang.dotnet・lang.go・test.core を含む)を lazyvim.json にまとめ、lua/config/lazy.lua の個別 import は削除しました。

重複プラグイン設定・未使用ファイルの整理

  • lua/plugins/go.lua / lua/plugins/example.lua を削除: go.lua の gopls 用ワークアラウンドは LazyVim 標準の lang.go Extra に同じ処理がすでに含まれていたため削除し、テンプレートのまま残っていた example.lua も消しました。
  • .neoconf.json と lua/plugins/yazi.lua を削除: 最初は .neoconf.json から廃止された neodev ブロックだけ抜いていましたが、よく確認すると lazyvim.json で lsp.neoconf Extra 自体を有効にしておらず neoconf.nvim も未導入だったため丸ごと削除しました。同様に LazyVim Extras にない yazi.nvim の enabled = false スタブ(lua/plugins/yazi.lua)も削除し、:Lazy! clean で lazy-lock.json から除去しています。
  • markdownlint 設定ファイルを1本化: 設定ディレクトリ直下に .markdownlint-cli2.yaml・.markdownlint-cli2.jsonc・.markdownlint.json・.markdownlintrc の4つが混在し、しかも MD013(1行の長さ制限)が false と 80 で食い違っていました。lua/plugins/markdown.lua が参照している .markdownlint-cli2.yaml だけを残し、他3つを削除しました。
  • LazyVim 本体と重複・無視されていた設定の削除:
  • csharp.lua に書いていた mason-lspconfig.nvim の automatic_enable = { exclude = { "omnisharp" } } は、LazyVim 本体の lsp/init.lua が独自 setup を呼ぶため読まれていませんでした(同じファイル内の servers.omnisharp = { enabled = false } だけで自動起動は除外されます)。
  • markdown.lua の conform.nvim に残っていた default_format_opts(旧キーの lsp_fallback = true 記述)、marksman の旧 single_file_support = false、無効化済み render-markdown.nvim の dependencies を削除し、フォーマットフォールバックは LazyVim 標準の lsp_format = "fallback" に任せました。
  • ui.lua の markdown-preview.nvim に書いていた Windows 用独自 build(cmd.exe では ; 区切りが通らない)を削って lang.markdown Extra 標準の mkdp#util#install() に任せ、LazyVim 本体と重複していた grug-far.nvim の定義(vim.bo.buftype == "" ガードも欠けていた)を削除しました。
  • mason.nvim の ensure_installed から各 Extra と重複していた netcoredbg・delve・js-debug-adapter と、nvim-dap-virtual-text の重複定義を外し、逆に languages.lua で漏れていた shellcheck を ensure_installed に追加してコメントも実装に合わせて修正しました。
  • omnisharp-extended-lsp.nvim の無効化: C# は omnisharp を止めて roslyn_ls を使っているため、lang.dotnet Extra が連れてくる Hoffs/omnisharp-extended-lsp.nvim は enabled = false にしました。
  • Snacks Dashboard の右ペイン整理(lua/plugins/ui.lua): 検索とコードの読み方が「Development Flow」と「Code Reading & Navigation Loop」の両方にあったので、「Code Reading & Search」にまとめました。「入口検索」「構造と編集」の下に「AI & Review」を置き、SidekickでCLIを開く <leader>aa と、CodeDiffで差分を見る <leader>ar を並べています。

3. プラグイン構成を入れ替える

telescope.nvim を外し snacks.picker へ一本化

以前の記事では、引用符囲みや -t / --iglob の細かい指定用に <leader>sG だけ telescope-live-grep-args を残していました。

ただ、すでにメインの <leader>sg では snacks.picker に -t / -g 挿入を入れて運用できていました。そこで snacks.nvim の grep に <c-k>(検索語の自動引用)も追加し、telescope.nvim 本体・telescope-live-grep-args.nvim・options.lua の Telescope* ハイライト定義を外して Picker を1つにまとめました。キー定義は Snacks / LazyVim 既定と同じ小文字表記(<c-k>, <a-t>, <a-g>)にそろえ、Snacks.win の大文字小文字不一致による重複警告が出ないようにしています。

diffview.nvim → codediff.nvim & sidekick.nvim 導入

AIが生成した差分を見る用途で sindrets/diffview.nvim を使っていましたが、本家の更新が長く止まっているため、VS Code 風の行・文字単位ハイライトとライブレビューを備えた codediff.nvim へ切り替えました。

あわせて、以前の記事では Neovim 外(Herdr の別ペイン)だけに置いていた AI CLI 操作について、LazyVim 標準の sidekick.nvim(ai.sidekick Extra)を導入しました。私は Copilot ではなくローカルの AI CLI(codex 等)を使うため、nes = { enabled = false } として Copilot LSP が自動起動しない設定にしています。また、sidekick.nvim が <leader>ad(Detach CLI)を使うため、CodeDiff 側は <leader>ar(:CodeDiff)と <leader>aH(:CodeDiff history %)へ配置して衝突を避けました。

codediff.nvimで設定変更の差分を開いた画面。左側の変更一覧と右側の行・文字単位ハイライトの並列比較を表示

nvim-dap-ui → nvim-dap-view へ置き換え

デバッグ記事の時点では nvim-dap-ui の下部パネルを4行まで縮めてコード領域を確保していましたが、同じ思想でさらに省スペースな単一ウィンドウ・タブ切替型の nvim-dap-view へ切り替えました。<leader>du で :DapViewToggle、<leader>dw で :DapViewWatch、<leader>de の式評価は nvim-dap 標準の require("dap.ui.widgets").hover() を使うようにしています。

読み込み順は、nvim-dap 側の dependencies に nvim-dap-view を置き、逆向きの依存指定を外してそろえました。auto_toggle = true でデバッグの開始時にパネルが開きます。端末の開き方を変えていた独自設定も外し、出力は Console タブで見ます。

11月20日、WSL2で設定のコピーを使い、Pythonのサンプルで確かめました。stopOnEntry を指定した自作の launch.json を信頼してから最初の <F5> を押すと、1行目で止まり、画面下にScopesが自動で開きました。

Pythonサンプルを初回のF5で起動した画面。1行目で停止し、下部にnvim-dap-viewのScopesが開いている

今回あえて変えなかったもの

  • C# LSP(roslyn_ls の維持): 高度なソリューション管理を行う seblyng/roslyn.nvim という選択肢もありますが、現状の roslyn_ls+Mason 導入済み roslyn-language-server で問題なく動いており(過去記事)、別レジストリ導入を伴うため今回は据え置きました。
  • Neovim 0.12 の vim.pack / vim._core.ui2: 0.12 の新機能として注目されていますが、LazyVim v16 が lazy.nvim と noice.nvim を前提に統合されているため、今回は LazyVim の仕組みに乗る方針を維持しています。

4. 実装と突き合わせて見つけた不具合・不要な負荷の修正

11月19日に LazyVim やプラグイン側の Lua コードを読みながら再チェックしたところ、見た目では気づきにくいバグが複数見つかりました。

  1. nvim-lint の markdownlint-cli2 から "-" が消えていた問題(markdown.lua)
  2. linters["markdownlint-cli2"].args = { "--config", ... } と書いていたため、nvim-lint 組み込みの args = { "-" }(標準入力を待ち受ける引数)が vim.tbl_deep_extend で上書き消滅していました。LazyVim の linting 設定 が用意している prepend_args に直し、さらに全言語の InsertLeave lint を止めていた events = { "BufReadPost", "BufWritePost" } の上書きも削除しました。
  3. nvim-dap の config 全置換で dap.core が丸ごと無効化されていた問題(debug.lua)
  4. mfussenegger/nvim-dap に config = function() を書いていたため、LazyVim dap.core Extra の config が置き換わり、mason-nvim-dap.setup・DapStoppedLine / Dap* サイン・vscode.json_decode の JSONC コメント除去パッチが一度も動いていませんでした。
  5. opts = function() に切り替えて dap.core の初期化を生かし、mason-nvim-dap.nvim の handlers では独自構成を持つ python・delve・coreclr・js の自動ハンドラを無効化して上書きを防ぎました。また C#: Debug project (portable) で project.dotnet_target() が nil の場合にエラー通知して早期 return するよう直しています。
  6. lualine.nvim の init 上書きで vim.g.lualine_laststatus が nil になる問題(lualine.lua)
  7. 独自に init = function() vim.o.laststatus = 3 end を置いていたせいで、LazyVim 本体の vim.g.lualine_laststatus 退避処理がスキップされていました。独自 init を削除して本体に任せ、あわせて CRLF 表示の bold = true も lualine 仕様の gui = "bold" へ直しました。
  8. blink.cmp 選択行ハイライトの誤付与とイベント追従漏れ(blink.lua)
  9. まず BlinkCmpMenuOpen / BlinkCmpMenuClose でメニュー表示中だけ動くようにして通常入力中の不要な vim.schedule を削りました。さらに実装確認で、メニューが開いた直後の未選択状態(preselect = false)でも 1 行目に誤って BlinkCmpSelectedText を貼っていた点と、候補移動が CompleteChanged ではなく User イベント BlinkCmpListSelect で通知される点が見つかったため、vim.wo[window].cursorline 判定と BlinkCmpListSelect 購読へ直しました。
  10. platform.prepend_path の nil 途切れ(platform.lua)
  11. 可変長引数を ipairs({ ... }) で回していたため、csharp.lua から先頭に nil の dotnet_root が渡ると後続の mason_bin が PATH に入らず終わっていました。select("#", ...) を使うループへ直しています。
  12. dap_utils.lua の不具合・非推奨 API 修正(dap_utils.lua)
  13. decode_jsonc の簡易正規表現(文字列中の // を壊しうる)を plenary.json.json_strip_comments に変更しました。
  14. run_pre_launch_task は引数のテーブル配列化に加え task.command への ${workspaceFolder} 展開を追加し、.NET 既定ビルド判定も *.slnx とサブディレクトリの .csproj に対応しました。
  15. launch_compound で 2 個目以降がすべて 5000ms 後に同時起動していた遅延を (i - 1) * 5000 に直し、launch_go_tty は同名バッファ再作成の E95 を防ぐため既存バッファ削除+bufhidden = "wipe" とし、非推奨の vim.fn.termopen も vim.fn.jobstart(..., { term = true }) へ置き換えました。
  16. グローバルの spell = true 解除(options.lua)と WinSeparator の適用タイミング修正(colorscheme.lua)
  17. コードや補助バッファまで効いていた vim.opt.spell = true を外して vim.opt.spelllang = { "en", "cjk" } のみにし、WinSeparator の色は solarized-osaka.nvim の on_highlights に移して起動直後から反映されるようにしました。
  18. CHEATSHEET.md 更新と <leader>? キー競合の解消(keymaps.lua / autocmds.lua / CHEATSHEET.md)
  19. LazyVim 標準の <leader>?(which-key のバッファ別キー一覧)を奪っていたチートシート用キーマップを <leader>u? へ移動し、CHEATSHEET.md も最新の操作体系へ同期しました。autocmds.lua では CHEATSHEET%.md$ のエスケープと fnameescape、コメントアウト残骸の削除も行っています。

起動して確かめたこと

設定を見直して :Lazy! clean、:Lazy! sync、:CodeDiff install を実行し、Neovim v0.12.1・LazyVim v16.0.2の起動時に読み込まれる設定を --headless で確認しました。

  • stylua --check:エラーなし
  • markdownlint-cli2(CHEATSHEET.md):0 error
  • Markdown 表示と Lint・整形:wrap=true, linebreak=true, breakindent=true, conceallevel=0、markdownlint-cli2 引数末尾に "-" 維持、nvim-lint イベント(BufReadPost / BufWritePost / InsertLeave)、conform lsp_format = "fallback"
  • nvim-dap と nvim-dap-view:require("dap") だけで nvim-dap-view が自動ロードされ、dap.listeners.before.launch["dap-view"]・DapBreakpoint サイン・DapStoppedLine・JSONC デコード("https://a/b//c" と "//flag" 保持)・4言語アダプタがすべて有効
  • UI・キーマップ・補助関数:vim.g.lualine_laststatus == 3 かつ vim.o.laststatus == 3、BlinkCmpListSelect 購読、Snacks.picker.grep() 起動時の重複警告 0 件、platform.prepend_path(nil, ...) の正常連結、jobstart(..., { term = true }) 起動、<leader>?(which-key)と <leader>u?(CheatSheet)の両立、WinSeparator(#ff9e64 bold)の反映

今回いちばん意外だったのは、自分のデバッグ設定を足したときに、LazyVimの初期化まで置き換えていたことです。独自設定を opts に移し、デバッグ開始時の自分の設定と、LazyVimが用意するサインやJSONCの処理を両方使えるようにしました。

参考リンク

コメント

タイトルとURLをコピーしました