Git は、開発者がコードを管理し、効果的に共同作業を行うのに役立つ強力なバージョン管理システムです。しかし、特に Git を使い始めたばかりの場合、混乱を招く可能性のあるエラーメッセージに遭遇することがあります。よくあるエラーの 1 つに「Your local changes would be overwritten by merge（ローカルの変更がマージによって上書きされます）」があります。このエラーは、Git がコミットされていないローカルの変更を上書きしてしまうため、安全にマージできない場合に発生します。
この実験（Lab）では、このエラーの原因、解決方法、そして今後の Git ワークフローでこのエラーの発生を防ぐための戦略の実装方法について学びます。
マージコンフリクトの解決方法に入る前に、基本的な Git ワークフローを理解し、エラーを再現するための環境をセットアップしましょう。
Git は、複数の開発者が互いの作業を妨げることなく、同じコードベースで作業できるようにする分散型バージョン管理システムです。ファイルの変更を時間の経過とともに追跡し、必要に応じて以前のバージョンに戻すことができます。
一般的な Git ワークフローには、次の手順が含まれます。
git add で変更をステージングするgit commit で変更をコミットするgit push で変更をリモートリポジトリにプッシュするgit pull で変更をリモートリポジトリからプルするまず、プロジェクトディレクトリに移動します。
cd /home/labex/project/git-merge-demoリポジトリの状態を確認しましょう。
git status次のような出力が表示されるはずです。
On branch main
nothing to commit, working tree clean次に、存在するブランチを確認しましょう。
git branch次のように表示されるはずです。
development
* mainアスタリスク (*) は、現在 main ブランチにいることを示しています。リポジトリ内のファイルを見てみましょう。
ls -la次のように表示されるはずです。
total 20
drwxr-xr-x 3 labex labex 4096 ... .
drwxr-xr-x 3 labex labex 4096 ... ..
drwxr-xr-x 8 labex labex 4096 ... .git
-rw-r--r-- 1 labex labex 24 ... README.md
-rw-r--r-- 1 labex labex 27 ... script.js
-rw-r--r-- 1 labex labex 25 ... styles.cssこれらのファイルの内容を見てみましょう。
cat README.md
cat script.js
cat styles.css素晴らしい！これで、リポジトリの構造を理解できました。次のステップでは、「local changes would be overwritten by merge（ローカルの変更がマージによって上書きされます）」エラーを生成するシナリオを作成します。
このステップでは、「Your local changes would be overwritten by merge（ローカルの変更がマージによって上書きされます）」エラーにつながるシナリオを作成します。これにより、このエラーが発生する理由を理解できます。
まず、development ブランチに切り替えて、いくつかの変更を加えましょう。
git checkout development次のように表示されるはずです。
Switched to branch 'development'次に、script.js ファイルを変更しましょう。
echo "console.log('Hello from development branch!');" > script.jsこの変更をコミットしましょう。
git add script.js
git commit -m "Update script.js on development branch"次のように表示されるはずです。
[development xxxxxxx] Update script.js on development branch
1 file changed, 1 insertion(+), 1 deletion(-)次に、main ブランチに戻りましょう。
git checkout mainmain ブランチにいることを確認しましょう。
git branch次のように表示されるはずです。
development
* main次に、同じファイル (script.js) を main ブランチで変更しますが、今回は変更をコミットしません。
echo "console.log('Hello from main branch!');" > script.jsワーキングディレクトリにコミットされていない変更がある状態で、development ブランチを main ブランチにマージしてみましょう。
git merge development次のようなエラーメッセージが表示されるはずです。
error: Your local changes to the following files would be overwritten by merge:
script.js
Please commit your changes or stash them before you merge.
Abortingおめでとうございます！「Your local changes would be overwritten by merge（ローカルの変更がマージによって上書きされます）」エラーを生成するシナリオを正常に作成しました。
このエラーは、次の理由で発生します。
development ブランチで script.js を変更し、変更をコミットしました。main ブランチでも script.js を変更しましたが、変更をコミットしませんでした。次のステップでは、このエラーを解決する方法を学びます。
「Your local changes would be overwritten by merge（ローカルの変更がマージによって上書きされます）」エラーを解決する最も一般的で便利な方法の 1 つは、git stash を使用することです。git stash コマンドは、コミットされていない変更を一時的に保存し、後で適用できるようにします。
git stash は、コミットされていない変更（ステージング済みと未ステージングの両方）を取得し、後で使用するために保存し、ワーキングコピーの変更を元に戻す Git コマンドです。
git stash を使用して、コミットされていない変更を保存しましょう。
git stash次のような出力が表示されるはずです。
Saved working directory and index state WIP on main: xxxxxxx Initial commitこのメッセージは、変更が保存されたことを確認します。ワーキングディレクトリがクリーンになったことを確認しましょう。
git status次のように表示されるはずです。
On branch main
nothing to commit, working tree clean次に、script.js の内容を確認しましょう。
cat script.js元の内容が表示されるはずです。
console.log('Hello, Git!');ワーキングディレクトリがクリーンになったので、development ブランチを安全にマージできます。
git merge development次のように表示されるはずです。
Updating xxxxxxx..xxxxxxx
Fast-forward
script.js | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)もう一度 script.js の内容を確認しましょう。
cat script.jsこれで、次のように表示されるはずです。
console.log('Hello from development branch!');development ブランチを正常にマージしたので、stashed された変更を取得しましょう。
git stash list次のように表示されるはずです。
stash@{0}: WIP on main: xxxxxxx Initial commitこれは、1 つの stash が保存されていることを示しています。適用しましょう。
git stash applyコンフリクトメッセージが表示される場合があります。
Auto-merging script.js
CONFLICT (content): Merge conflict in script.jsこれは正常です。Git がマージされたファイルの上に stashed された変更を適用しようとしているためです。script.js の内容を確認しましょう。
cat script.js次のようなものが表示されるはずです。
<<<<<<< Updated upstream
console.log('Hello from development branch!');
=======
console.log('Hello from main branch!');
>>>>>>> Stashed changesこれは、手動で解決する必要があるマージコンフリクトです。nano を使用してファイルを開きます。
nano script.js両方の変更を保持するか、1 つを選択するようにファイルを編集します。
// Keep both changes
console.log("Hello from development branch!");
console.log("Hello from main branch!");Ctrl+O、Enter の順に押してファイルを保存し、Ctrl+X を押して nano を終了します。
次に、解決されたコンフリクトをステージングしてコミットしましょう。
git add script.js
git commit -m "Merge development branch and resolve conflict"おめでとうございます！git stash を使用して、「Your local changes would be overwritten by merge（ローカルの変更がマージによって上書きされます）」エラーを正常に解決しました。
前のステップでは、git stash を使用して「Your local changes would be overwritten by merge（ローカルの変更がマージによって上書きされます）」エラーを解決しました。このステップでは、この状況を処理するための代替アプローチを検討します。
「Your local changes would be overwritten by merge（ローカルの変更がマージによって上書きされます）」エラーを回避する最も簡単な方法の 1 つは、マージ操作を実行する前に変更をコミットすることです。
これを実証するために、別のシナリオを作成しましょう。まず、styles.css ファイルを変更しましょう。
echo "body { background-color: #f0f0f0; }" > styles.css次に、変更を stashing する代わりに、コミットしましょう。
git add styles.css
git commit -m "Update styles.css on main branch"次のように表示されるはずです。
[main xxxxxxx] Update styles.css on main branch
1 file changed, 1 insertion(+), 1 deletion(-)次に、development ブランチに切り替え、同じファイルに変更を加え、コミットしましょう。
git checkout development
echo "body { background-color: #e0e0e0; }" > styles.css
git add styles.css
git commit -m "Update styles.css on development branch"次に、main ブランチに戻りましょう。
git checkout mainここでマージを試みると、変更をコミットしたため、「ローカルの変更が上書きされる」エラーは発生しません。ただし、マージコンフリクトが発生する可能性があります。
git merge development次のように表示される場合があります。
Auto-merging styles.css
CONFLICT (content): Merge conflict in styles.css
Automatic merge failed; fix conflicts and then commit the result.これは、両方のブランチがファイルの同じ部分に変更をコミットした場合に発生する、別の種類のコンフリクトです。このコンフリクトを解決しましょう。
cat styles.css次のように表示されるはずです。
<<<<<<< HEAD
body { background-color: #f0f0f0; }
=======
body { background-color: #e0e0e0; }
>>>>>>> developmentファイルを編集してコンフリクトを解決しましょう。
nano styles.css内容を次のように変更します。
body {
background-color: #f5f5f5;
}ファイルを保存し、解決されたコンフリクトをコミットします。
git add styles.css
git commit -m "Resolve merge conflict in styles.css"もう 1 つのアプローチは、不要になった場合は、ローカルの変更を単に破棄することです。
## Create a change to README.md
echo "## Updated README" > README.md
## Check the status
git status次のように表示されるはずです。
On branch main
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git checkout -- <file>..." to discard changes in working directory)
modified: README.md
no changes added to commit (use "git add" and/or "git commit -a")これらの変更が不要だと判断した場合は、破棄できます。
git checkout -- README.mdステータスをもう一度確認しましょう。
git status次のように表示されるはずです。
On branch main
nothing to commit, working tree cleanそして、README.md の内容は元の状態に復元されました。
cat README.mdこれらの代替方法は、特定の状況とニーズに基づいて、「Your local changes would be overwritten by merge（ローカルの変更がマージによって上書きされます）」エラーを処理するためのさまざまなオプションを提供します。
「Your local changes would be overwritten by merge（ローカルの変更がマージによって上書きされます）」エラーを解決する方法を理解したところで、この問題がそもそも発生しないようにするためのベストプラクティスについて説明しましょう。
小さく、頻繁なコミットを行うことで、マージコンフリクトの可能性を減らすことができます。
## Make a small change
echo "// Add a comment" >> script.js
## Commit the change
git add script.js
git commit -m "Add a comment to script.js"変更を push する前に、常にリモートリポジトリから変更を pull してください。
## In a real scenario, you would do:
## git pull origin main
## Since we're working locally, let's simulate this by checking out development and back
git checkout development
git checkout main各機能またはバグ修正に対して新しいブランチを作成します。
## Create a new feature branch
git checkout -b feature-navbar
## Make some changes
echo "/* Navigation bar styles */" >> styles.css
## Commit the changes
git add styles.css
git commit -m "Add navigation bar styles"main ブランチに戻りましょう。
git checkout mainFeature ブランチを main ブランチで最新の状態に保ちます。
## Switch to the feature branch
git checkout feature-navbar
## In a real scenario, you would merge or rebase with main:
## git merge main
## or
## git rebase main
## For our demonstration, let's simulate this
echo "/* More styles */" >> styles.css
git add styles.css
git commit -m "Add more styles"
## Go back to main
git checkout mainマージや pull などの操作を実行する前に、常にリポジトリのステータスを確認してください。
git status次のように表示されるはずです。
On branch main
nothing to commit, working tree cleanこれは実験では実演できませんが、コンフリクトを回避するにはコミュニケーションが重要です。チームがどのファイルで作業しているかを確認し、同じファイルへの同時変更を避けてください。
複雑なマージコンフリクトの場合は、GUI ツールを検討してください。
## List available GUI merge tools (in a real environment)
## git mergetool --tool-help
## In our case, let's just display what merge tools are typically available
echo "Common merge tools: meld, kdiff3, vimdiff, vscode"これらのベストプラクティスに従うことで、マージコンフリクトの発生と、Git ワークフローでの「Your local changes would be overwritten by merge（ローカルの変更がマージによって上書きされます）」エラーを大幅に減らすことができます。
この実験では、「Your local changes would be overwritten by merge（ローカルの変更がマージによって上書きされます）」エラーを Git で解決する方法を学びました。これは、作業ディレクトリに未コミットの変更がある状態で、変更をマージまたは pull しようとすると発生する一般的な問題です。
この実験で取り上げた主なポイントは次のとおりです。
異なるブランチで同じファイルを変更することにより、「Your local changes would be overwritten by merge（ローカルの変更がマージによって上書きされます）」エラーをトリガーするシナリオを作成しました。
このエラーを解決するための複数の方法を学びました。
git stash を使用して、変更を一時的に保存するgit checkout を使用して、不要なローカルの変更を破棄するマージコンフリクトを防止するためのベストプラクティスを検討しました。
git status を頻繁に使用するこれらの概念とテクニックを理解することで、Git ワークフローをより効率的に管理し、マージコンフリクトにつながる一般的な落とし穴を回避できます。
Git はバージョン管理とコラボレーションのための強力なツールですが、コンフリクトを回避するには、変更を慎重に管理する必要があることを忘れないでください。この実験で学んだスキルは、他の人と効果的にコラボレーションしながら、コードベースの整合性を維持するのに役立ちます。
