Git チェックアウト上書きエラーを理解する
機能開発に集中していた矢先、急な障害報告が届きました。ブランチを切り替えて修正しようとしますよね？git checkout another-branch と入力した瞬間、こんなエラーが出て愕然とします：
error: Your local changes to the following files would be overwritten by checkout:
file.txt
Please commit your changes or stash them before you switch branches.
Aborting
このエラーメッセージは、Git がその役割を果たしている証拠です。つまり、あなたの作業を守ってくれているのです。現在のブランチにコミットされていない変更があります。例に示されているように、file.txt への変更などがその例です。もし Git が単純に another-branch に切り替えた場合、それらの変更が失われたり、切り替え先のブランチのファイルで上書きされたり、混乱した状態になる可能性があります。Git はこのデータ損失を防いでくれます。操作を中断し、取るべき行動を明確に指示してくれます：変更をコミットするか、スタッシュしてください。
ステップごとの修正手順：チェックアウト前にコミットされていない変更を解消する
このエラーが表示されたら、まず作業ディレクトリの現在の状態を確認することが先決です。Git が何を問題視しているかを正確に把握するために、必ず git status から始めましょう。
git status
このコマンドで、変更済み・ステージ済み・追跡されていないファイルが明らかになります。これらの変更を保持したいのか、一時的に保存したいのか、それとも破棄したいのかによって、主に3つの選択肢があります。
選択肢1：変更をコミットする（準備が整っている場合）
現在の変更が完成していて、安定しており、ブランチの履歴に含める準備ができているなら、コミットが最も直接的な解決策です。小さな独立したタスクや、より大きな機能の論理的な区切りを完了した場合に最適です。
-
変更をステージする：
git add .
これにより、変更済みの全ファイルと新規ファイルがステージされます。特定のファイルだけをステージしたい場合は、明示的にリストアップしてください（例：`git add file.txt another_file.js`）。
-
**変更をコミットする：**
```
git commit -m "feat: Complete initial implementation of new login form"
常に明確でわかりやすいコミットメッセージを使用しましょう。後で修正やスカッシュを予定している一時的な変更の場合は、"WIP: temporary changes before switching branch" のように「WIP」（作業中）のメッセージを使うことを検討してください。
-
ブランチを切り替える：
git checkout another-branch
または、新しいバージョンの Git を使用している場合：
```bash
git switch another-branch
ローカルの変更が現在のブランチの履歴に安全に記録されたので、問題なくブランチを切り替えられます。
選択肢2：変更をスタッシュする（コミットの準備ができていない場合）
変更がまだコミットできる状態ではないけれど、失いたくない場合も多いでしょう。そんな時にこそ git stash が役立ちます。このコマンドは、変更済みの追跡ファイルとステージ済みの変更を取り出し、未完了作業用の特別な「スタック」に保存します。そして、作業ディレクトリをクリーンな状態に戻します。今取り組んでいる作業を一時的に脇に置くようなイメージです。
-
変更をスタッシュする：
git stash save "WIP: Login form redesign before bug fix"
スタッシュが複数になることが予想される場合は特に、`"WIP: Login form redesign before bug fix"` のような説明的なメッセージを付けることを強くお勧めします。メッセージがない場合、Git はデフォルトで現在のブランチ名とコミットメッセージを使用します。
追跡済みファイルと未追跡ファイルの両方（無視されたファイルを除く）を素早くスタッシュするには、次を使用します：
```bash
git stash -u
または、無視されたファイルを含む全ファイルをスタッシュする場合（注意して使用してください）：
```bash
git stash -a
-
**作業ディレクトリがクリーンであることを確認する：**
```bash
git status
「nothing to commit, working tree clean」と表示されるはずです。
-
ブランチを切り替える：
git checkout another-branch
または：
```bash
git switch another-branch
-
（後で）スタッシュした変更を再適用する：
元のブランチ（または適用したい別のブランチ）に戻ったら、スタッシュした変更を元に戻せます。
スタッシュ一覧を確認するには：
git stash list
最新のスタッシュを再適用してスタッシュリストから削除するには：
```bash
git stash pop
特定のスタッシュ（例：stash@{1}）を再適用して削除するには：
```bash
git stash pop stash@{1}
スタッシュをリストに残したまま再適用するには（複数のブランチに適用したい場合や内容を確認したい場合に便利）：
```bash
git stash apply
選択肢3：変更を破棄する（不要な場合）
変更が実験的なものであったり、誤って加えたものであったり、単に不要になった場合もあります。それらを完全に破棄して、作業ディレクトリを最後にコミットした状態に戻したいと確信しているなら、この選択肢を使います。
警告：この操作は元に戻せません。実行前に、これらの変更を本当に失っても構わないかどうか確認してください。
-
追跡済みファイルへの変更を破棄する：
git restore .
このコマンド（Git 2.23以降で利用可能）は、変更済みの追跡ファイルをすべて最後のコミット時の状態に戻します。古いバージョンの Git を使用している場合は、次を使用してください：
```bash
git checkout -- .
または特定のファイルのみを対象にする場合：
```bash
git restore file.txt
-
**未追跡のファイルとディレクトリを破棄する：**
まだ Git に追加されていない新規ファイル（未追跡ファイル）がある場合、`git restore` や `git checkout -- .` ではそれらは削除されません。その場合は `git clean` が必要です。
まず、削除されるものを確認するためのドライランを実行します：
```bash
git clean -n
未追跡ファイルを削除するには：
```bash
git clean -f
未追跡ファイルと未追跡ディレクトリを削除するには：
```bash
git clean -df
繰り返しになりますが、git clean はファイルを完全に削除するため、十分に注意して使用してください。
-
作業ディレクトリがクリーンであることを確認する：
git status
「nothing to commit, working tree clean」と表示されるはずです。
-
**ブランチを切り替える：**
```bash
git checkout another-branch
または：
```bash
git switch another-branch
## 確認手順
いずれかの解決策を適用したら、ブランチの切り替えが成功したこと、そして作業ディレクトリが期待通りの状態になっていることを確認することが重要です。
-
**現在のブランチを確認する：**
```bash
git branch
出力には、切り替えたかった another-branch（または目的のブランチ）の横にアスタリスク（*）が表示されているはずです。
-
作業ディレクトリの状態を確認する：
git status
「On branch another-branch」および「nothing to commit, working tree clean」と表示されるはずです。
-
**`git stash` を使用した場合、スタッシュリストを確認する（任意）：**
```bash
git stash list
git stash pop を使用した場合、そのスタッシュエントリはリストから消えているはずです。git stash apply を使用した場合は、まだリストに残っています。
Git ワークフローをスムーズにするためのヒント
-
こまめなコミット： 小さく、頻繁に、意味のあるコミットを心がけましょう。この習慣により、大量のコミットされていない変更がワークフローの妨げになる可能性が大幅に減ります。また、作業の取り消しや管理もずっと簡単になります。
-
git stashを理解する： コンテキスト切り替え時の救世主です。stash、stash list、stash apply、stash popを使いこなせるようにしましょう。 -
高度なシナリオには
git worktreeを活用する： ブランチ間を頻繁に素早く切り替え、同時並行で作業する必要がある場合は、git worktreeの使用を検討してください。同じリポジトリから複数のブランチを別々のディレクトリにチェックアウトして、複数の作業ツリーを持つことができます。
git worktree add ../hotfix-branch hotfix/urgent-bug
これにより、`hotfix/urgent-bug` ブランチがチェックアウトされた新しいディレクトリ `../hotfix-branch` が作成され、元のリポジトリは現在のブランチのままになります。
-
**未追跡ファイルに注意する：** 未追跡ファイルは、多くの場合ビルド成果物や一時ファイルです。これらが `git status` に表示されてワークスペースが散らかるのを防ぐために、`.gitignore` ファイルを適切に設定しましょう。それにより、`git clean` の必要性も減ります。