【実務・中級編】Vim/Neovimでの大量データ置換術：Quickfixリストとcdoコマンドで巨大ログファイルを一括修正する – 軽量・高機能テキストエディタ生産性向上バイブル

大規模リファクタリングの極意：NeovimとQuickfixによる「破壊なき一括置換」の流儀

大規模なコードベースにおいて、特定のパターンを全方位的に修正する瞬間、多くのエンジニアは安易に `sed` や `find` をパイプで繋いで実行し、その結果の不可逆性に冷や汗をかく。しかし、Vim/Neovimを真に理解したアーキテクトにとって、一括置換とは「慎重かつ段階的なトランザクション」であるべきだ。

本稿では、NeovimのQuickfixリストをハブとし、安全かつ劇的に高速な一括置換を実現する「プロの作法」を伝授する。

—

1. なぜ `sed` ではなく `cdo` なのか

`sed -i` は強力だが、修正の結果を事前にプレビューできず、正規表現の衝突による意図しない破壊のリスクが常に付きまとう。

Neovimの `cdo` (Command for each entry in Quickfix list) は、「候補となるファイルをリストアップし、一つずつ検証しながら一括適用する」というプロセスをエディタ内で完結させる。これにより、修正プロセスを「認知可能な形」で管理できるのだ。

実践：巨大プロジェクトでの一括置換フロー

1. grepで対象を絞る: `:vimgrep /検索パターン/gj /.ext`
2. リストを精査: `:copen` でリストを開き、不要な修正対象を `:cdelete` で除外する。
3. 安全な置換: `:cdo s/旧/新/gc` (最後に `c` を付けるのがプロの証だ。全て自動で適用する `g` は、CI環境以外では使うべきではない)。
4. 一括保存: `:cfdo update`

このフローを経ることで、手動操作と自動化の境界線上で、人間による最終検知を組み込んだ最も安全なリファクタリングが可能となる。

—

2. 開発効率を異次元へ引き上げる「神プラグイン」構成

プラグインは「道具」ではない。「自身の神経系の拡張」である。以下の3つは、Vimの能力をアーキテクチャレベルで底上げする。

[nvim-telescope/telescope.nvim](https://github.com/nvim-telescope/telescope.nvim): QuickfixリストをGUI的に操作するための不可欠なハブ。`grep_string` や `live_grep` の結果を即座にQuickfixへ送るために使う。
[folke/trouble.nvim](https://github.com/folke/trouble.nvim): Quickfixリストを「別ウィンドウ」で美しく可視化する。修正の進捗状況が一目で把握でき、精神的負荷が激減する。
[numToStr/Comment.nvim](https://github.com/numToStr/Comment.nvim): 置換の前後で、コメントアウトして一時的に無効化する操作を極限まで高速化する。

—

3. 実践的設定：チーム開発での「共有化ルール」

設定の共有において、`init.lua` を汚すのは悪手である。プロジェクト固有の設定は `.nvim.lua` をルートディレクトリに配置し、Luaの動的ロードを活用せよ。

プロジェクト特化型 `.nvim.lua` のベストプラクティス

— プロジェクト単位のローカル設定（チーム共有用）
vim.opt_local.shiftwidth = 4 — インデント幅をプロジェクトの規約に強制
vim.opt_local.makeprg = “npm run test” — プロジェクトのCIコマンドをショートカットに紐付け

— 特定のパスを除外するグローバルgrep設定
vim.opt.grepprg = “rg –vimgrep –smart-case –glob ‘!/dist/’ –glob ‘!/node_modules/'”

—

4. 現場で震えるほど役立つ「隠れたショートカット」

設定ファイルに以下のマッピングを追加するだけで、Quickfixの操作性は劇的に向上する。

— cdoの結果を保存して、次の修正へ素早く移るためのキーバインド
vim.keymap.set(‘n’, ‘cw’, ‘:cdo update | update‘, {desc = “Quickfixの内容を全保存”})

— 現在の単語を即座にgrepし、Quickfixに飛ばす
vim.keymap.set(‘n’, ‘gg’, ‘:grep! :copen‘, {desc = “カーソル下の単語をgrep”})

—

アーキテクトからのメッセージ：ツールと対話せよ

多くのエンジニアは、Vimを「テキストを編集するツール」と見なしている。しかし、それは誤りだ。Vimは「テキストというデータを、正規表現とLSPの力で構造的に変換するオペレーティングシステム」である。

`cdo` を使いこなすということは、置換という行為を単なる文字列の入れ替えではなく、「ファイル群に対する一貫した構造変更のプロセス」として設計する力を持つことと同義である。

明日から、`sed` のコマンドを打つ前に一度立ち止まってほしい。その変更は、Quickfixリストに乗せて「検証可能なプロセス」にできるのではないか？その一瞬の思索が、君のコードベースを、そして君自身を、一段上のエンジニアへと押し上げるはずだ。

さあ、エディタを開こう。あなたのプロジェクトは、より洗練されるのを待っている。