Gitのブランチとマージ — コンフリクトの読み方と解消手順

Gitのブランチとマージ。分岐して合流する線と、変更を調整する書類と工具。

ブランチは「作業を分ける仕組み」ではなく、「壊しても戻れる場所を作る仕組み」です。

1人で書いているうちは、main に直接コミットしても困りません。困るのは、作りかけの機能があるのに、別の急ぎの修正が入ったときです。作りかけを消すわけにもいかず、混ぜて出すわけにもいかない。この「同時に2つ持てない」が、ブランチを知らないときの詰まり方です。

この記事では、手元のリポジトリでブランチを切って、2つの変更を並行して進め、片方だけ先に取り込み、わざとコンフリクトを起こして解消するところまでをやります。コンフリクトは事故ではなく、Git が「ここは自分で決めて」と聞いてきている状態です。読み方さえ分かれば怖くありません。

対象レベル: PC入門 / 区分: 必修

目次

この記事でわかること

  • ブランチがファイルのコピーではないこと。何を指しているのか
  • merge の2種類(早送りと、マージコミットを作る合流)の違いと、見分け方
  • コンフリクトの表示(<<<<<<< の行)の読み方と直し方
  • コミットしていない変更を持ったままブランチを移れないときの対処
  • 作業が終わったブランチを消してよい理由

この記事でやること

  1. 練習用のリポジトリを1つ作る(既存のプロジェクトには触りません)
  2. ブランチを2本切って、別々のファイルを直して合流させる(コンフリクトなし)
  3. ブランチを2本切って、同じ行を直して合流させる(コンフリクトあり)
  4. コンフリクトを解消してコミットする
  5. ブランチを消す。消したあとで中身が残っていることも確かめる

先に知る言葉

この記事で初めて出てくる言葉です。 詳しくは用語集にもまとめてあります。

言葉意味
ブランチどのコミットを指しているかを覚えている付箋。 ファイルのコピーではない
マージ2 本のブランチを1 本に合流させること
コンフリクト同じ場所を両方が別々に直したため、Git がどちらか決められない状態。エラーではなく質問
HEADいま自分がいる場所。HEAD~1 は「その 1 つ前」
stashコミットせずに、変更をいったん脇へ退けること

前提と作業場所

Windows の PowerShell で打ちます。 VM は使いません。Git の導入と user.name の設定が終わっていることが前提です。まだの場合は先にそちらを済ませてください。

いま Git が入っているかは、これで分かります。

bash
$ git --version

バージョンが表示されれば入っています。表示されない場合は、この記事より前の回に戻ってください。

この記事に出てくる a1b2c3d のような英数字は、実行例です。 コミットに付く番号は作るたびに変わるので、同じにはなりません。自分の画面に出た番号に読み替えてください。

練習用のリポジトリを作る

既存のフォルダは使いません。 消してよい場所を1つ作ります。

bash
$ cd ~
$ mkdir branchlab
$ cd branchlab
$ git init
$ git branch -M main

git branch -M main は、最初のブランチの名前を main に決める指定です。Git のバージョンによって既定が master のことがあるので、揃えておきます。

中身を2つ作ってコミットします。

"# 練習用" | Out-File -Encoding utf8 README.md
"ページのタイトル" | Out-File -Encoding utf8 title.txt
git add .
git commit -m "最初のコミット"

ここが出発点です。この時点でブランチは main の1本だけです。

ブランチは、コピーではない

先に、いちばん誤解しやすいところを潰しておきます。

ブランチを作っても、ファイルはコピーされません。 増えるのは「名前」だけです。ブランチとは、どのコミットを指しているかを覚えているだけの付箋です。

bash
$ git branch feature-a
$ git branch

出力はこうなります。

  feature-a
* main

* が付いているのがいま自分がいるブランチです。feature-a を作りましたが、中身はまったく同じで、どちらも同じコミットを指しています。

指している先は、これで見えます。

bash
$ git log --oneline --all --decorate
a1b2c3d (HEAD -> main, feature-a) 最初のコミット

1つのコミットに、名前が2つぶら下がっている状態です。フォルダが2つできたわけではありません。ここを「コピーができた」と思っていると、あとで「消したらファイルが消えるのでは」と怖くなります。消えるのは付箋だけです。

ぶつからない合流を、まずやる

feature-a へ移動します。

bash
$ git switch feature-a
$ git branch

* が feature-a に移っていれば成功です。git switch は移動のための命令です。古い記事では git checkout と書かれていることがありますが、同じことをします。checkout は役割が多すぎたので、移動用に分けられたのが switch です。

ここで README.md だけを直します。

"# 練習用" | Out-File -Encoding utf8 README.md
"" | Out-File -Encoding utf8 -Append README.md
"ブランチの練習をしています。" | Out-File -Encoding utf8 -Append README.md
git add README.md
git commit -m "READMEに説明を足した"

main に戻ると、足した行は消えています。

git switch main
Get-Content README.md

# 練習用 の1行だけに戻っているはずです。ファイルが消えたのではありません。 いま main が指しているコミットの中身が表示されているだけです。

合流させます。

bash
$ git merge feature-a
Updating a1b2c3d..e4f5g6h
Fast-forward
 README.md | 2 ++
 1 file changed, 2 insertions(+)

Fast-forward と出たら、それは「早送り」です。 main は feature-a を作ってから1つも進んでいなかったので、付箋を前に動かしただけで済みました。新しいコミットは作られていません。

ぶつかる合流をやる

ここからが本題です。2本のブランチが、同じ行を別々に直した状態を作ります。

まず main で title.txt を直します。

git switch main
"社内システムの案内" | Out-File -Encoding utf8 title.txt
git add title.txt
git commit -m "タイトルを社内システムの案内にした"

次に、さっきの分岐点からもう1本切ります。

bash
$ git switch -c feature-b HEAD~1

-c は「作って移動する」の意味です。HEAD~1 は「いまいるコミットの1つ前」です。ここが分岐点になります。

"申請システムのご案内" | Out-File -Encoding utf8 title.txt
git add title.txt
git commit -m "タイトルを申請システムのご案内にした"

いま、title.txt の同じ場所を、2本のブランチが別の内容に書き換えています。Git には、どちらが正しいか判断できません。

bash
$ git switch main
$ git merge feature-b
Auto-merging title.txt
CONFLICT (content): Merge conflict in title.txt
Automatic merge failed; fix conflicts and then commit the result.

これが「コンフリクト」です。エラーではありません。 Git が「両方あるので、どちらにするか決めてください」と止まっただけです。

コンフリクトの表示を読む

ファイルを開きます。

PowerShell
PS> Get-Content title.txt
<<<<<<< HEAD
社内システムの案内
=======
申請システムのご案内
>>>>>>> feature-b

読み方は3つだけ覚えれば済みます。

記号意味
<<<<<<< HEADここから下はいまいるブランチ(合流先)の内容
=======境目
>>>>>>> feature-bここまでが持ち込もうとしたブランチの内容

直し方は「記号ごと消して、残したい形にする」だけです。片方を選んでもいいし、両方を踏まえた新しい文にしても構いません。Git は選択肢を並べているだけで、正解を持っていません。

ここでは、両方を踏まえた文にします。

"申請システムの案内" | Out-File -Encoding utf8 title.txt
Get-Content title.txt

山かっこや = の行が1つも残っていないことを確かめてください。この記号を消し忘れたままコミットするのが、いちばん多い失敗です。動くはずのファイルが動かなくなり、原因がここだと気づくのに時間がかかります。

解消したことを Git に伝えて、コミットします。

bash
$ git add title.txt
$ git commit -m "タイトルの表記を統一した"

今度は Fast-forward ではなく、マージコミットという新しいコミットが1つ作られます。2本の流れが1つに合流した記録です。

bash
$ git log --oneline --graph --all
*   9h8g7f6 タイトルの表記を統一した
|\
| * 5e4d3c2 タイトルを申請システムのご案内にした
* | 2b1a0z9 タイトルを社内システムの案内にした
|/
* e4f5g6h READMEに説明を足した
* a1b2c3d 最初のコミット

枝分かれして、また1本に戻っている形が見えます。これが「合流した」ということです。

コミットしていない変更を持ったまま移ろうとしたとき

実際の作業でいちばん出るのが、これです。

"書きかけ" | Out-File -Encoding utf8 -Append title.txt
git switch feature-a
error: Your local changes to the following files would be overwritten by checkout:
        title.txt
Please commit your changes or stash them before you switch branches.
Aborting

これは親切な拒否です。 title.txt は main(「申請システムの案内」)と feature-a(「ページのタイトル」)で中身が違うので、そのまま移ると、書きかけが上書きされて消えるからです。⚠️ 逆に、README.md のようにどちらのブランチでも同じ中身のファイルなら、書きかけがあっても拒否されず、変更を持ったまま移動します(M README.md と表示されるだけ)。取れる道は3つあります。

やりたいこと打つもの結果
ここで区切ってよいgit add . のあと git commit -m "作業中"コミットして移動できる
まだコミットしたくないgit stashいったん脇に退ける。戻すのは git stash pop
この変更は要らないgit restore title.txt捨てる。戻せません

ここでは退けてみます。

git stash
git switch feature-a
git switch main
git stash pop
Get-Content title.txt

「書きかけ」の行が戻っていれば成功です。stash は「あとで戻す前提の一時退避」で、忘れて溜めると何を退けたか分からなくなります。git stash list で残りを確認できます。

この行はもう要らないので、捨てておきます。

bash
$ git restore README.md

使い終わったブランチを消す

合流が済んだブランチは、付箋としての役目が終わっています。消します。

bash
$ git branch -d feature-a
$ git branch -d feature-b
$ git branch

main だけになりました。コミットは1つも消えていません。 確かめます。

bash
$ git log --oneline --graph

さきほどの枝分かれがそのまま残っているはずです。消えたのは名前だけで、これがブランチの正体でした。

-d は合流済みのときだけ消せる指定です。合流していないブランチを -d で消そうとすると拒否されます。-D にすると拒否を無視して消せますが、合流していないコミットは辿る手がかりを失います(しばらくは git reflog から拾えます)。普段は -d だけを使ってください。

つまずいたところ

コンフリクトの記号を消し忘れました。 ======= の行が残ったままコミットしてしまい、設定ファイルが読み込めなくなりました。エラーは「構文が不正」としか言わないので、原因に辿り着くまで時間がかかりました。解消したら、必ず記号が0個であることを目で確かめてください。

ブランチを消すのが怖くて、20本ほど溜めました。 どれが終わったものか分からなくなり、結局どれも消せなくなりました。消しても中身は消えないと分かってからは、合流したその場で消しています。

git stash したことを忘れました。 別の日に git stash list を見たら3つ溜まっていて、どれが何か分かりませんでした。退けるときは、その日のうちに戻すつもりのものだけにしています。

後片づけ

練習用のフォルダを消します。この記事で作ったのは ~/branchlab だけです。

cd ~
Remove-Item -Recurse -Force branchlab

消す前に、いまどこにいるかを Get-Location で確かめてください。別のフォルダで打つと、関係のないものを消します。

まとめ

  • ブランチはコピーではなく、どのコミットを指しているかの付箋。だから消しても中身は残る
  • 合流には2種類ある。Fast-forward は付箋を動かすだけ、そうでなければマージコミットが1つできる
  • コンフリクトはエラーではなく質問。山かっこの行から始まる範囲を、残したい形に書き直して記号を消す
  • コミットしていない変更があると移動は拒否される。コミットするか、stash するか、捨てるかの3択
  • 合流済みのブランチは -d で消す。-D は普段使わない

参考リンク

次に読む

この記事は 【第0段階】作業場所を作る の 12 / 18 本目です。

記事
← 前の記事Windowsの仮想化はどれを選ぶか — Hyper-V・VMware・WSL2
→ 次の記事VMware Workstation導入 — 無料化後の初期設定

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次