Gitエラー「追跡されていないファイルがチェックアウトで上書きされます」の原因と解決方法

Gitでプロジェクトの変更履歴を管理していると、さまざまなエラーに遭遇することがあります。特に、ブランチを切り替える際に次のようなエラーが表示されることがあります。

error: the following untracked working tree files would be overwritten by checkout

[ファイルのリスト]

Please, commit your changes or stash them before you can switch branches.

このエラーは、現在のブランチに存在するファイルが、切り替え先のブランチでも変更されている場合に発生します。解決方法はとてもシンプルで、エラーメッセージの最後に書かれている指示に従うだけです。具体的には「変更をコミットする」か「スタッシュする」の2つの方法があります。

方法1：変更をコミットする

変更をコミットするには、次のコマンドを入力します。

git commit -m "ここにわかりやすいコミットメッセージを入力"

これで作業ツリーがクリーンな状態になります。その後、git checkout <ブランチ名> を実行すれば、問題なくブランチを切り替えられます。

方法2：変更をスタッシュ（stash）する

git stash を使うと、コミットする準備が整うまで変更内容を一時的に保存できます。スタッシュは変更を保持しますが、自分で取り出すまでコミットやブランチには関連付けられません。

スタッシュを使用するには、ローカルリポジトリで以下のコマンドを順に実行します。

git stash push
git checkout <切り替え先のブランチ>
--- 切り替え先のブランチで必要な作業を行う ---
git checkout <元のブランチ>
git stash pop

スタックの仕組みを理解していれば、この操作は直感的に把握できるでしょう。スタックとは「後入れ先出し（LIFO）」と呼ばれるデータ構造で、最新のスタッシュはリストの末尾に追加され、必要になったタイミングでpopで取り出します。

デフォルトの動作では、git stash pop はリストの最後の要素を取り出し、スタッシュから完全に削除します。もしスタッシュを削除せずに内容だけ適用したい場合は、git stash apply を使用してください。

まとめ

この記事では、チェックアウト時に作業ツリーのファイルが上書きされるエラーを解決する2つの方法を紹介しました。多くの場合、Gitのエラーメッセージに書かれた指示にそのまま従うだけで問題は解決します。今回のケースでは、変更を「コミット」するか「スタッシュ」することで作業ツリーをクリーンにし、スムーズにブランチを切り替えられます。

どちらの方法を選ぶべきかは、チームのGitワークフローによって異なります。変更を正式な履歴として残したい場合はコミットを、後で整理したい一時的な変更であればスタッシュが適しています。どちらを選べばよいかわからないときは、遠慮なくチームメンバーに相談しましょう。ハッピーハッキング！