Gitエラー「ローカル変更がマージによって上書きされます」の原因と4つの解決方法

Gitのバージョン管理において、「Your local changes to the following files will be overwritten by merge（次のファイルへのローカル変更はマージによって上書きされます）」というエラーメッセージが表示されることがあります。このエラーは、ローカル環境で編集したファイルが、リモートリポジトリ側でも変更されている場合に発生します。

未コミットのファイルがリモートリポジトリでも変更されていなければ、このエラーは発生しません。このメッセージが表示された際は、チームの他のメンバーに相談し、意見を聞くのが最善です。ローカルの変更をマージするか、リポジトリ側のバージョンを優先するかにかかわらず、全員が足並みを揃えておくことが重要です。

リポジトリとは？Gitにおけるpushとpullの仕組み

リポジトリとは、コードを保存しておく場所であり、GitHubなどのバージョン管理システムを通じて、チームメンバーによって常に更新・取得されるものです。Pullとは、リポジトリの最新バージョンを、自分のローカル環境やIDE（統合開発環境）であるPyCharmなどに取り込む操作を指します。

Pullを行った後、コードに変更を加えたり、新機能を追加したりします。作業が完了したらPushを実行してコードをリポジトリへ反映させます。こうすることで変更が保存され、他のメンバーも最新のコードにアクセスできるようになります。

GitHubのバージョン管理に不慣れな方は、まず基本操作を一通り学んでおくことをおすすめします。本記事では、読者がすでに基礎知識を持っていることを前提として解説を進めます。

「ローカル変更がマージによって上書きされます」エラーの解決方法

このエラーの解決方法は、何を実現したいかによって異なります。ローカルの変更を破棄してリポジトリの内容を取得するか、あるいはローカルの変更をstash（退避）に保存してからリポジトリのバージョンを取得するかを選択できます。どちらを採るかは、状況と目的次第です。

先に進む前に、必ずチームメンバーと相談し、全員が同じ認識を持っていることを確認しましょう。誤ったコミットや間違ったバージョンのプッシュは、チーム全体の作業に影響を及ぼす可能性があります。

方法1：強制的にpullしてローカル変更を上書きする

ローカルでの変更が不要で、リポジトリのコードをそのまま取得したい場合は、強制的にpullを実行できます。これにより、ローカル環境のすべての変更が上書きされ、リポジトリのバージョンと同じ状態になります。

IDEで以下のコマンドを実行してください。

git reset --hard
git pull

この操作により、すべてのローカル変更が即座に失われるため、実行前に自分が何をしているのかを十分理解し、ローカルの変更が本当に不要であることを確認してください。

方法2：ローカルとリポジトリの両方の変更を保持する

ローカルの変更とリポジトリ側の変更の両方を残したい場合は、変更をaddしてコミットしてからpullします。この場合、当然ながらマージコンフリクトが発生します。そこで、IDEに用意されているツール（difftoolやmergetoolなど）を使って2つのコードを比較し、どの変更を保持し、どの変更を破棄するかを判断します。これは中間的なアプローチであり、手動で削除しない限り変更が失われることはありません。

git add $the_file_under_error
git commit
git pull

マージコンフリクトが発生したら、コンフリクト解決ツールを起動し、1行ずつ丁寧に確認していきましょう。

方法3：両方の変更を保持するがコミットはしない

デバッグ中の未完成コードがあり、まだコミットしたくないという場面はよくあります。そんなときは、変更をstashで安全に退避させ、リポジトリから最新バージョンを取得してから、stashしたコードを復元する方法が有効です。

git stash save --keep-index

または

git stash

git pull
git stash pop

stashをpopした後にコンフリクトが発生した場合は、通常の方法で解決してください。コンフリクトの影響でstashしたコードを失いたくない場合は、popの代わりに以下のコマンドを使用できます。

git stash apply

また、マージが適切な選択肢ではないと感じる場合は、rebaseの利用を検討してみてください。rebaseとは、一連のコミットを新しいベースコミットへ移動または統合する操作のことです。rebaseを使う場合は、コマンドを以下のように変更します。

git stash
git pull --rebase origin master
git stash pop

方法4：コードの特定の部分だけを変更する

コードの一部だけを変更し、すべてを置き換えたくない場合は、上書きされたくないファイルをすべてコミットしてから、方法3の手順に従います。リポジトリのバージョンで上書きしたいファイルについては、次のコマンドを使用します。

git checkout path/to/file/to/revert

または

git checkout HEAD^ path/to/file/to/revert

さらに、対象ファイルがステージングされていないことを、以下のコマンドで確認しておきましょう。

git reset HEAD path/to/file/to/revert

その後、pullコマンドを実行します。

git pull

これにより、リポジトリから最新バージョンを取得しようとします。状況に応じて最適な方法を選び、チームと連携しながらスムーズにエラーを解消してください。