git merge — 枝分かれした歴史をつなぐ

付箋をずらすだけのマージ — fast-forward

1. 作業用のブランチ memo を作って乗り換えます。いまは main と memo の付箋が、同じ 卵を追加 に貼ってあります。

   $ git switch -c memo
   Switched to a new branch 'memo'

2. memo の上で、新しいファイル notes.txt を書きます。

   $ echo "牛乳は低脂肪" > notes.txt

3. notes.txt をステージに載せます。

   $ git add notes.txt

4. memo だけが メモを追加 に進みました。main は 卵を追加 に残っています。

   $ git commit -m "メモを追加"
   [memo b78e6bd] メモを追加
    1 file changed, 1 insertion(+)
    create mode 100644 notes.txt

5. main に戻ります。作業ツリーから notes.txt が消えたのは、main のコミットにまだ入っていないからです。

   $ git switch main
   Switched to branch 'main'

6. main の 卵を追加 は、memo の メモを追加 の親、つまり 祖先 です。だから Git は新しいコミットを作らず、付箋 main を メモを追加 へずらすだけで済ませます（Fast-forward）。--ff-only は「早送りで済むときだけ進める」指定で、ここでは済むので通ります。

   $ git merge --ff-only memo
   Updating 8b41d07..b78e6bd
   Fast-forward
    notes.txt | 1 +
    1 file changed, 1 insertion(+)
    create mode 100644 notes.txt

7. もう一度 merge すると、Already up to date.（もう取り込み済み）と答えて何もしません。memo のコミットは、すべて main から辿れるからです。

   $ git merge memo
   Already up to date.

8. 取り込み済みなので、付箋 memo は -d で剥がせます。コミット メモを追加 は main から辿れるので消えません。

   $ git branch -d memo
   Deleted branch memo (was b78e6bd).

9. 歴史は1本のまっすぐな列のままです。fast-forward では、「ブランチで作業した」という跡はグラフに残りません。

   $ git log --oneline
   b78e6bd (HEAD -> main) メモを追加
   8b41d07 卵を追加
   3f2a9c1 牛乳を追加

両方が進んでいたら — マージコミット

1. 今度は main と memo が、買い物リストを作る から別々に進んでいます。main は1行目を 牛乳を2本買う に、memo は notes.txt を足してから4行目を バターを2箱買う に変えました。

   $ git log --oneline --all
   7c3e915 (HEAD -> main) 牛乳を2本に
   d29f4b7 (memo) バターを2箱に
   a61c0e8 メモを追加
   3f2a9c1 買い物リストを作る

2. main の先頭は memo の祖先ではないので、付箋をずらすだけでは追いつけません。--ff-only は Not possible to fast-forward, aborting.（早送りできないので中止します）と止まり、何も変えません。

   $ git merge --ff-only memo
   hint: Diverging branches can't be fast-forwarded, you need to either:
   hint:
   hint: 	git merge --no-ff
   hint:
   hint: or:
   hint:
   hint: 	git rebase
   hint:
   hint: Disable this message with "git config set advice.diverging false"
   fatal: Not possible to fast-forward, aborting.

3. オプションを付けない merge は、親が2つの マージコミット を作ります。同じ todo.txt でも、変えた行が離れていれば Auto-merging todo.txt（自動で混ぜた）で済みます。

   $ git merge memo
   Auto-merging todo.txt
   Merge made by the 'ort' strategy.
    notes.txt | 1 +
    todo.txt  | 2 +-
    2 files changed, 2 insertions(+), 1 deletion(-)
    create mode 100644 notes.txt

4. 1行目は main の変更、4行目は memo の変更で、両方が入っています。

   $ cat todo.txt
   牛乳を2本買う
   卵を買う
   パンを買う
   バターを2箱買う

5. main から辿れるコミットに、memo の2つが加わりました。git log はマージコミットの親を両方辿るので、2本の枝のコミットが1列に並びます。

   $ git log --oneline
   942c065 (HEAD -> main) Merge branch 'memo'
   7c3e915 牛乳を2本に
   d29f4b7 (memo) バターを2箱に
   a61c0e8 メモを追加
   3f2a9c1 買い物リストを作る

6. 取り込んだあとに同じ merge を打っても、Already up to date. で何も起きません。

   $ git merge memo
   Already up to date.

7. memo のコミットはすべて main から辿れるので、-d で付箋を剥がせます。

   $ git branch -d memo
   Deleted branch memo (was d29f4b7).

早送りできてもマージコミットを作る — --no-ff

1. 1 の merge の前と同じ形です。memo が main より1つ先にあり、ふつうに merge すれば早送りになります。

   $ git log --oneline --all
   5d7e2b4 (memo) メモを追加
   8b41d07 (HEAD -> main) 卵を追加
   3f2a9c1 牛乳を追加

2. --no-ff を付けると、早送りできる場面でも マージコミット を作ります。Merge made by the 'ort' strategy.（ort という方式でマージした）は、マージコミットを作ったときの出力です。グラフでは 卵を追加 からの線と メモを追加 からの線が、新しいコミットで合流します。

   $ git merge --no-ff memo
   Merge made by the 'ort' strategy.
    notes.txt | 1 +
    1 file changed, 1 insertion(+)
    create mode 100644 notes.txt

3. メッセージには Merge branch 'memo' が自動で付きます。マージコミットの親は2つで、1つ目が 卵を追加（それまでの main）、2つ目が メモを追加 です。

   $ git log --oneline
   361488b (HEAD -> main) Merge branch 'memo'
   5d7e2b4 (memo) メモを追加
   8b41d07 卵を追加
   3f2a9c1 牛乳を追加

4. 付箋 memo を剥がしても、メモを追加 はマージコミットの2つ目の親として main から辿れます。

   $ git branch -d memo
   Deleted branch memo (was 5d7e2b4).

5. memo の札は消えましたが、「ここで memo を取り込んだ」というマージコミットが歴史に残りました。GitHub の Merge pull request がいつも作るのが、この形です。

   $ git log --oneline --all
   361488b (HEAD -> main) Merge branch 'memo'
   5d7e2b4 メモを追加
   8b41d07 卵を追加
   3f2a9c1 牛乳を追加

同じ行を両方が変えたとき — コンフリクト

1. main は2行目を 卵を2つ買う に、feature は同じ2行目を 卵を6つ買う に変えています。どちらを採るか Git には決められないので、CONFLICT (content): Merge conflict in todo.txt と言って途中で止まります。ここから先のプロンプトには、(main|MERGING)（マージの途中）と付きます。

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

2. ぶつかった行に、Git が 印 を書き込みました。<<<<<<< HEAD から ======= までが今のブランチ（main）の側、======= から >>>>>>> feature までが取り込もうとした相手の側です。ぶつからなかった1行目と3行目は、そのまま残っています。

   $ cat todo.txt
   牛乳を買う
   <<<<<<< HEAD
   卵を2つ買う
   =======
   卵を6つ買う
   >>>>>>> feature
   パンを買う

3. You have unmerged paths.（まだ解決していないファイルがある）と、both modified:（両方が変えた）が出ます。直して commit するか、git merge --abort でやめるか、の案内も出ています。

   $ git status
   On branch main
   You have unmerged paths.
     (fix conflicts and run "git commit")
     (use "git merge --abort" to abort the merge)
   
   Unmerged paths:
     (use "git add <file>..." to mark resolution)
   	both modified:   todo.txt
   
   no changes added to commit (use "git add" and/or "git commit -a")

4. 印を消して、残したい中身にファイルを書き直します。ここでは 卵を6つ買う を採りました。両方を残しても、別の文に書き換えてもかまいません。

   $ printf '牛乳を買う\n卵を6つ買う\nパンを買う\n' > todo.txt

5. マージの途中の git add は、「このファイルは 解決した」という印を付ける意味になります。

   $ git add todo.txt

6. All conflicts fixed but you are still merging.（コンフリクトは全部直ったが、まだマージの途中）に変わりました。あとは commit でマージを締めくくります。

   $ git status
   On branch main
   All conflicts fixed but you are still merging.
     (use "git commit" to conclude merge)
   
   Changes to be committed:
   	modified:   todo.txt
   

7. --no-edit は、Git が用意したメッセージ Merge branch 'feature' をそのまま使う指定です。親が2つのマージコミットができてマージの途中が終わり、プロンプトから MERGING が外れます。

   $ git commit --no-edit
   [main dc55e06] Merge branch 'feature'

8. 卵を2つ と 卵を6つ の両方が、main の歴史に入りました。いまのファイルの中身は、手で直した 卵を6つ買う です。

   $ git log --oneline
   dc55e06 (HEAD -> main) Merge branch 'feature'
   c3c3c3c (feature) 卵を6つ
   b4e81a2 卵を2つ
   3f2a9c1 買い物リストを作る

やめて元に戻す — merge --abort

1. 4 と同じ場面です。merge がコンフリクトで止まりました。

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

2. 解決していないファイルがあるうちは、commit できません（Committing is not possible because you have unmerged files.）。最後の行の U は、Unmerged（未解決）の印です。

   $ git commit -m "とりあえず保存"
   error: Committing is not possible because you have unmerged files.
   hint: Fix them up in the work tree, and then use 'git add/rm <file>'
   hint: as appropriate to mark resolution and make a commit.
   fatal: Exiting because of an unresolved conflict.
   U	todo.txt

3. ブランチの乗り換えも、you need to resolve your current index first（先に解決して）と止められます。止まった merge は、片づけるまで付いて回ります。

   $ git switch feature
   error: you need to resolve your current index first
   todo.txt: needs merge

4. 直しかけて、卵を4つ買う と書いてみました。でも、このマージは今はやめることにします。

   $ printf '牛乳を買う\n卵を4つ買う\nパンを買う\n' > todo.txt

5. git merge --abort は、merge を打つ前の状態に戻します。付箋もコミットも動かず、作業ツリーとステージが 卵を2つ のコミットの中身に戻ります。直しかけた 卵を4つ買う も消えます。

   $ git merge --abort

6. マージの途中ではなくなり、作業ツリーもきれいです。プロンプトからも MERGING が消えました。

   $ git status
   On branch main
   nothing to commit, working tree clean

7. 卵を2つ買う に戻っています。feature はそのまま残っているので、あとでいつでも merge し直せます。

   $ cat todo.txt
   牛乳を買う
   卵を2つ買う
   パンを買う

2台で枝分かれしたら — fetch して merge して push

1. 2-3 の続きです。Windows のノート PC で、GitHub の様子を確かめずに todo.txt に1行書き足します。

   $ echo "バターを買う" >> todo.txt

2. 手元の main が バターを追加 に進みました。

   $ git commit -am "バターを追加"
   [main 15e1410] バターを追加
    1 file changed, 1 insertion(+)

3. 同じころ、Mac でも メモを追加 を作って push しました。GitHub 側の main は、手元とは別の方向へ進みます。

4. push は (fetch first) で拒否されます。GitHub 側の メモを追加 を消さないために、Git が止めています。

   $ git push
   To https://github.com/you/memo-app.git
    ! [rejected]        main -> main (fetch first)
   error: failed to push some refs to 'https://github.com/you/memo-app.git'
   hint: Updates were rejected because the remote contains work that you do not
   hint: have locally. This is usually caused by another repository pushing to
   hint: the same ref. If you want to integrate the remote changes, use
   hint: 'git pull' before pushing again.
   hint: See the 'Note about fast-forwards' in 'git push --help' for details.

5. fetch すると メモを追加 が手元に届き、origin/main がそこへ進みます。手元のグラフでも、卵を追加 から2本に分かれたのが見えるようになりました。

   $ git fetch
   From https://github.com/you/memo-app
      c43e6a8..9ae3d51  main       -> origin/main

6. have diverged（枝分かれした）と出ます。2-3 では、ここで git pull --ff-only が止まりました。今度は2本をつなぎます。

   $ git status
   On branch main
   Your branch and 'origin/main' have diverged,
   and have 1 and 1 different commits each, respectively.
     (use "git pull" if you want to integrate the remote branch with yours)
   
   nothing to commit, working tree clean

7. 取り込む相手は、追跡ブランチ origin/main でもかまいません。バターを追加 と メモを追加 を親に持つマージコミットができ、メッセージは Merge remote-tracking branch 'origin/main' になります。

   $ git merge origin/main
   Merge made by the 'ort' strategy.
    notes.txt | 1 +
    1 file changed, 1 insertion(+)
    create mode 100644 notes.txt

8. ahead of 'origin/main' by 2 commits に変わりました。バターを追加 とマージコミットの2つが、まだ GitHub に無いコミットです。もう枝分かれではありません。

   $ git status
   On branch main
   Your branch is ahead of 'origin/main' by 2 commits.
     (use "git push" to publish your local commits)
   
   nothing to commit, working tree clean

9. 今度は push が通ります。手元の main は GitHub 側の メモを追加 を含んでいるので、GitHub の付箋は前に進むだけで、何も消えないからです。

   $ git push
   To https://github.com/you/memo-app.git
      9ae3d51..530423b  main -> main

10. Windows の バターを追加 も Mac の メモを追加 も、GitHub の main に残りました。git fetch → git merge origin/main → git push が、枝分かれを解く手順の1つです。

    $ git log --oneline
    530423b (HEAD -> main, origin/main, origin/HEAD) Merge remote-tracking branch 'origin/main'
    9ae3d51 メモを追加
    15e1410 バターを追加
    c43e6a8 卵を追加
    3f2a9c1 牛乳を追加