PhpStormの「Local History」で泣きを見る前に：Gitコミット前の修正を完璧にプロジェクトの命綱にする技術
テックリードの私たちがどれほど厳格なGit運用（Git-FlowやGitHub Flowなど）を敷いていたとしても、現場のエンジニアが最も恐怖する瞬間は「コミットする前の、あの数分間のスラッシュ＆バーン」にある。
- 「あ、これ試行錯誤のためにごっそり書き換えたけど、ボツだわ。元に戻そう」
- 「あれ、さっき動いていたロジックをどこで消したっけ？」
- 「`git add .` を忘れて `git checkout` やら `git clean` を叩いてしまい、未コミットの変更が宇宙の彼方へ消えた……」
絶望のあまり冷や汗が背中を伝うその瞬間、あなたを救い出す最後の砦が、JetBrains製IDEの隠れた最高傑作 「Local History（ローカル履歴）」 だ。
Gitが「開発者が明示的に残したマイルストーン」を管理するシステムであるならば、Local Historyは 「IDEがあなたのタイピングの全軌跡を自律的に記録し続けるタイムマシン」 である。今回は、この強力な機能を極限まで使い倒し、開発スピードと精神的安全性を圧倒的に高めるプロの実践テクニックを伝授しよう。
—
1. Local Historyの内部挙動：なぜGit管理外でも復元できるのか？
多くのエンジニアは、「GitがあるからIDEの履歴なんて不要だ」と誤解している。しかし、Local Historyのアーキテクチャを理解すれば、その考えがいかに危険であるかがわかる。
内部で何が起きているのか？
PhpStorm（IntelliJプラットフォーム）は、プロジェクト内のファイルに対するあらゆる変更（タイピング、リファクタリング、ファイル作成・削除、外部ツールによる変更）を、IDE内部のVFS（Virtual File System）層で監視し、独自のバイナリログとして `.idea/` ディレクトリ配下（またはIDEのシステム領域）に差分（Delta）として逐次記録している。
- Gitとの決定的な違い:
- Git: `git add` と `git commit` を明示しなければ履歴は残らない。ブランチを切り替える際のコンフリクトで未コミットの変更が吹き飛ぶリスクがある。
- Local History: 明示的な操作は一切不要。 ファイルを保存した瞬間だけでなく、タイピングの合間や、リファクタリングの自動実行単位で自動的にスナップショットが生成される。
つまり、「まだGitのステージングに乗せる価値すらない、殴り書きの実験的コード」であっても、Local Historyのタイムラインには確実に保存されているのだ。
—
2. 絶望の淵から生還する：具体的な復元手順と実践シナリオ
実務で遭遇しがちな「やっちまった」シーンを想定し、Local Historyを使った正確な復元アプローチを解説する。
シナリオ：誤ってファイルを削除し、さらにプロジェクト全体をクリーンアップしてしまった場合
不注意で重要なコントローラークラス（例: `PaymentController.php`）を削除し、さらにその後に `git reset –hard` や `git clean -fd` を実行してしまい、Gitの履歴上からもワークツリーからもファイルが綺麗に消え去ったとする。
1. ディレクトリレベルでのLocal History呼び出し
- プロジェクトツリーで、削除されたファイルが存在していた親ディレクトリ（例: `app/Http/Controllers`）を右クリックする。
- コンテキストメニューから [Local History] -> [Show History] を選択する。
2. タイムラインの特定
- 画面左側に、そのディレクトリに対して行われた過去の操作がタイムスタンプ付きでリストアップされる。
- 「File deletion」「External change」などのラベルを頼りに、ファイルを削除する直前の状態をクリックする。
3. 差分の確認と部分復元
- 画面右側に当時のファイルツリーと差分が表示される。消えた `PaymentController.php` が赤字（削除状態）で存在しているはずだ。
- 対象のファイルを右クリックし、[Revert] をクリックする。
たったこれだけで、Git管理外に吹き飛んだファイルが一瞬で復活する。
—
3. 開発スピードを極限まで高めるキーボードショートカット
マウス操作でメニューを辿っているようでは、テックリードの名が廃る。思考の速度を落とさないためのショートカットを体に叩き込め。
- 現在のファイルの履歴を開く:
- macOS: `⌂ ⇧ H` (Ctrl + Shift + H) または `⌥ ⇧ D`
- Windows/Linux: `Ctrl + Shift + H`
- アクションの検索から呼び出す（推奨）:
- `⌘ ⇧ A` (macOS) / `Ctrl + Shift + A` (Windows) で「Find Action」を開き、「Local History」とタイピングしてEnter。
—
4. チーム開発の生産性を底上げする：PhpStorm設定の共有化
Local History自体はローカル環境（`.idea`配下など）に閉じた機能だが、PhpStormのプロジェクト設定をチーム全体で統一することで、開発者ごとの余計なトラブルを防ぎ、エディタ環境起因のミスをゼロにできる。
チーム開発で必ず共有・バージョン管理すべきPhpStormの設定ファイル群を提示する。
設定ファイル構成例：`.idea/` 配下のベストプラクティス
PhpStormの設定はプロジェクトルートの `.idea/` ディレクトリに格納される。これをGitで管理することで、チーム全員のIDE環境を同期できる。
1. `.idea/vcs.xml` (バージョン管理・Local History関連設定)
2. `.idea/php.xml` (PHPランタイム・言語レベルの統一)
—
5. 絶対に入れるべき神プラグイン（Local Historyを補完するエコシステム）
PhpStormのデフォルト機能だけでも強力だが、以下のプラグインを組み合わせることで、コードの安全性と変更追跡能力はさらに劇的な進化を遂げる。
1. GitToolBox
- 概要: インラインで「誰がいつその行を変更したのか（Git Blame）」をコードの右側に表示するプラグイン。
- なぜ必要か: Local Historyが「自分の過去の実験的変更」を追うのに対し、GitToolBoxは「チームメンバーの意図」をリアルタイムで視覚化する。これらを併用することで、コードの変更履歴における死角が完全になくなる。
2. Rainbow Brackets
- 概要: ネストされた括弧の色を自動でカラフルに色分けし、スコープの視認性を極限まで高める。
- なぜ必要か: リファクタリングや複雑なロジックの書き換え時に、誤った位置でコードを削除・編集するヒューマンエラーを防ぐ。「どこからどこまでが対象ブロックか」が一目でわかるため、Local Historyにお世話になる回数そのものを減らしてくれる。
—
6. GitコミットとLocal Historyを併用するプロのワークフロー
最後に、私たちが現場で実践している「GitとLocal Historyの黄金律（Golden Rule）」を共有しよう。
1. 思いついたアイデアはすべてコードに叩き込む（Git非同期）
- 動くかどうかわからない実装、別アプローチの検証など、とりあえずエディタ上でガンガン書き殴る。この段階ではGitコミットは不要。
2. もしアプローチが失敗したら、迷わずLocal Historyを開く
- `git checkout` するまでもなく、Local Historyのタイムラインから「書き始める直前のスナップショット」を選択して部分的にRevert。
3. 綺麗に動くものができたら、ようやくGitステージングへ
- ロジックが固まったら `git add` し、意味のある粒度でコミットメッセージを添えてGitに残す。
—
まとめ
PhpStormのLocal Historyは、単なる「おまけの機能」ではない。それは、「失敗を恐れずに限界までアグレッシブなコードリファクタリングや実験を行うための、エンジニアの心理的安全性そのもの」である。
「Gitがあるから大丈夫」という慢心を捨て、Local Historyという最強のセーフティネットを背負いながら、誰よりも高速に、誰よりも美しいコードをプロダクションに送り出してほしい。あなたの開発ライフにおける「やっちまった」を、この瞬間からゼロにしよう。