伝説のエンジニアが教える「VimのUndo履歴」を魔法のように永続化する方法
こんにちは。開発環境の深淵を覗き込み、日々コーディングの「摩擦係数」を減らすことに情熱を燃やすエンジニアです。
皆さんは、VimやNeovimを使っていてこんな経験はありませんか？
「あ、今の変更を取り消したい」と思って `u` を押したのに、一度エディタを閉じてしまったために、昨日までの苦労の結晶（編集履歴）が水泡に帰してしまった……という悲劇。
実は、Vimには「永続Undo（Persistent Undo）」という強力な機能が備わっています。これを使えば、たとえPCを再起動しても、数日前に書いたコードの「あの一手」まで遡ることができます。今回は、ただの設定方法を教えるのではなく、なぜこれがデフォルトでオフなのか、そしてどう設定すれば「最強のタイムマシン」になるのかを、設計思想レベルから紐解いていきましょう。
—
1. なぜ「永続Undo」はデフォルトでオフなのか？
多くのエンジニアが「なぜこんな便利な機能が最初からオンになっていないんだ！」と疑問に思います。理由は至ってシンプルで、「メモリ管理とセキュリティのトレードオフ」だからです。
- データ構造の肥大化: Undo履歴は、編集の差分をバイナリデータとして保存します。大規模なプロジェクトで数ヶ月間履歴を溜め込むと、保存先がゴミファイルで溢れかえるリスクがあります。
- 環境の汚染: もし設定を適当にすると、OSのあらゆる場所に隠しファイルが散らばり、ディスク容量を圧迫します。
しかし、現代のストレージ容量と私たちの「開発効率」を天秤にかけたとき、この機能を有効化しない手はありません。適切に「ディレクトリを構造化」すれば、ゴミ掃除の心配すら不要になるのです。
—
2. 実践：Neovimで最強のUndo環境を構築する
まずは、設定ファイル（`init.lua`）に以下の記述を追加しましょう。単にディレクトリを指定するのではなく、「OS側で管理しやすい場所」に履歴を隔離するのがポイントです。
— Neovimの永続Undo設定
local undo_dir = vim.fn.expand(‘~/.local/state/nvim/undo’)
— Undoディレクトリが存在しない場合は自動作成
if vim.fn.isdirectory(undo_dir) == 0 then
vim.fn.mkdir(undo_dir, ‘p’) — pオプションで親ディレクトリも再帰的に生成
end
— 永続Undoを有効化
vim.opt.undofile = true
— 履歴の保存先を指定
vim.opt.undodir = undo_dir
【超重要】Gitブランチを跨ぐ際の「履歴の衝突」を防ぐには？
もしあなたが複数のブランチを行き来する開発者なら、さらに一歩進んだテクニックが必要です。実は、VimのUndoファイルは「ファイル名」をキーにして履歴を特定します。そのままでは、ブランチAで編集した内容が、ブランチBの同名ファイルに混ざってしまう可能性があります。
これを防ぐためには、「作業ディレクトリのパスをハッシュ化してUndoファイル名に含める」というプラグイン（`undotree`など）を使うか、あるいはシンプルに「プロジェクトごとにUndoディレクトリを分ける」運用を推奨します。
—
3. 動作確認：これが「タイムトラベル」だ
設定ができたら、実際に試してみましょう。
1. `nvim test.txt` を起動し、何か適当な文字を入力して保存（`:w`）して終了します。
2. 一度Neovimを完全に閉じます。
3. 再度 `nvim test.txt` で開きます。
4. ここで `u` キーを叩いてください。
……どうですか？ 終了したはずの履歴が、まるで昨日のことのように蘇るはずです。
もし履歴が反映されない場合は、`:set undofile?` と入力してください。`undofile` と表示されれば正しく設定されています。また、保存されたファイルは `~/.local/state/nvim/undo` を覗いてみてください。`%home%user%project%test.txt` のような形で、あなたの作業記録がバイナリとして刻まれているはずです。
—
4. 万が一、Undoファイルが壊れたら？
稀にですが、Neovimのクラッシュやディスクの書き込みエラーで、Undoファイルが破損することがあります。その際、「Undoファイルが壊れています」というエラーメッセージが出るかもしれません。
その時は恐れず、該当するファイルを削除してください。
該当するディレクトリに移動し、破損ファイルを削除するコマンド例
rm ~/.local/state/nvim/undo/%home%user%project%test.txt
これは「過去を捨てる」行為です。恐れることはありません。Gitがコードの正当性を保証している限り、Undo履歴はあくまで「保険」に過ぎませんから。
—
最後に：なぜこれをやるのか
ツールを使いこなすとは、単に便利な機能を知ることではありません。「自分の思考の過程を、ツールに深く刻み込むこと」です。
永続Undoを有効にすることで、あなたは「保存してから閉じれば履歴は消える」という既存の制約から解放されます。エディタがあなたの思考の断片を永続的に記録してくれる……これほど心強いパートナーは他にありません。
明日からのコーディングで、この「タイムマシン」をぜひ活用してください。あなたの開発ライフが、昨日よりも少しだけ、ストレスフリーになることを確信しています。