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


折り返しを比べた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.goExtra に同じ処理がすでに含まれていたため削除し、テンプレートのまま残っていたexample.luaも消しました。.neoconf.jsonとlua/plugins/yazi.luaを削除: 最初は.neoconf.jsonから廃止されたneodevブロックだけ抜いていましたが、よく確認するとlazyvim.jsonでlsp.neoconfExtra 自体を有効にしておらず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.markdownExtra 標準の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.dotnetExtra が連れてくる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 %)へ配置して衝突を避けました。

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が自動で開きました。

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

コメント