Gitのmerge –squashでコミットを1つにして取り込む方法

​​Git​コマンドライン

git merge --squash <ブランチ> を実行すると、ブランチの変更がまとめてステージされた状態になり、続けて git commit すると1つのコミットとして取り込まれます。作業ブランチに「パスワード欄を追加」のような細かいコミットが並んでいても、main の履歴には「ログイン画面を作る」のような1つのコミットだけを残したいときに使う方法です。GitHub のプルリクエストにある「Squash and merge」も、ブランチのコミットを1つにまとめて取り込む方法です。検証環境でコマンドを実行し、操作の前と後の出力をそのまま載せています。

補足

検証環境は Ubuntu 24.04、Git 2.43.0 です。作者の名前とメールアドレスには例示用の値(Neko <neko@example.com>)を設定し、コミットの日時は環境変数で決めました。エディターを手で操作する代わりに、渡された内容を表示してからメッセージを書き換える小さなシェルスクリプトを GIT_EDITOR に指定しています。本文のコマンドでは、この指定を省いています。Vim や VS Code などの実物のエディターでの操作、GitHub などのホスティングサービスの画面での操作、Windows と macOS での動作は試していません。

取り込む前の状態

main から feature ブランチを作り、ログイン画面の作業で3つのコミットを積みました。その間に main にも1つコミットが入っています。

console
$ git log --oneline --graph --all
* f52ca5e READMEに説明を追加
| * 6cc4aad ログインボタンを追加
| * 6e59ecd パスワード欄を追加
| * d106d3d ログイン画面を追加
|/  
* 6b9961f 最初のコミット

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

いまは main にいます。ここに feature の3つのコミットを、1つにして取り込みます。

git merge –squash で変更だけを持ってくる

取り込む側のブランチ(ここでは main)で git merge --squash を実行します。

console
$ git merge --squash feature
Automatic merge went well; stopped before committing as requested
Squash commit -- not updating HEAD

not updating HEAD とあるとおり、この時点ではまだコミットはできていません。git status を見ると、feature で足した login.txt がステージされた状態(Changes to be committed)になっています。main の最新のコミットも f52ca5e のままです。

console
$ git status
On branch main
Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
	new file:   login.txt

$ git log --oneline -1
f52ca5e READMEに説明を追加

$ git diff --cached --stat
 login.txt | 3 +++
 1 file changed, 3 insertions(+)

ステージされているのは、3つのコミットを順に当てたあとの最終的な差分です。途中の「ログイン画面を追加」や「パスワード欄を追加」の段階は、ここでは区別されません。

git merge の公式リファレンスには、--squash は本当にマージしたときと同じ作業ツリーとインデックスを作るが、コミットはせず、HEAD も動かさず、MERGE_HEAD も記録しないと書かれています。実際に .git/MERGE_HEAD はなく、代わりに .git/SQUASH_MSG ができていました。中身は、取り込んだコミットのメッセージを並べたものです。

console
$ ls .git/MERGE_HEAD
ls: cannot access '.git/MERGE_HEAD': No such file or directory

$ cat .git/SQUASH_MSG
Squashed commit of the following:

commit 6cc4aad37bd9a13525783a4d197d08431e5209ea
Author: Neko <neko@example.com>
Date:   Thu Nov 12 10:30:00 2026 +0900

    ログインボタンを追加

commit 6e59ecd5aa7b3e5fa118374dab537276fbecbc9e
Author: Neko <neko@example.com>
Date:   Thu Nov 12 10:20:00 2026 +0900

    パスワード欄を追加

commit d106d3dec8d06487ee93d50bbb595cfe07a0111c
Author: Neko <neko@example.com>
Date:   Thu Nov 12 10:10:00 2026 +0900

    ログイン画面を追加

git commit で1つのコミットにする

続けて git commit を実行すると、エディターが開きます。最初に入っているのは、さきほどの SQUASH_MSG の内容です。

console
$ git commit
----- エディターに渡された内容 -----
Squashed commit of the following:

commit 6cc4aad37bd9a13525783a4d197d08431e5209ea
Author: Neko <neko@example.com>
Date:   Thu Nov 12 10:30:00 2026 +0900

    ログインボタンを追加

commit 6e59ecd5aa7b3e5fa118374dab537276fbecbc9e
Author: Neko <neko@example.com>
Date:   Thu Nov 12 10:20:00 2026 +0900

    パスワード欄を追加

commit d106d3dec8d06487ee93d50bbb595cfe07a0111c
Author: Neko <neko@example.com>
Date:   Thu Nov 12 10:10:00 2026 +0900

    ログイン画面を追加

# Please enter the commit message for your changes. Lines starting
# with '#' will be ignored, and an empty message aborts the commit.
#
# On branch main
# Changes to be committed:
#	new file:   login.txt
#
----- ここまで(次の内容に書き換えて保存して閉じる) -----
ログイン画面を作る

- ログイン画面を追加
- パスワード欄を追加
- ログインボタンを追加
[main 24dd358] ログイン画面を作る
 1 file changed, 3 insertions(+)
 create mode 100644 login.txt

「エディターに渡された内容」から「ここまで」の行までが、エディターに最初に表示された内容です。そのまま保存すると、1行目の Squashed commit of the following: がコミットの件名になります。ここでは、件名を「ログイン画面を作る」にし、本文に作業の中身を箇条書きにした内容へ書き換えて保存しました。

コミットした後の履歴です。

console
$ git log --oneline --graph --all
* 24dd358 ログイン画面を作る
* f52ca5e READMEに説明を追加
| * 6cc4aad ログインボタンを追加
| * 6e59ecd パスワード欄を追加
| * d106d3d ログイン画面を追加
|/  
* 6b9961f 最初のコミット

$ git show --stat HEAD
commit 24dd3580641116faa12f66b381189b6c632e9ade
Author: Neko <neko@example.com>
Date:   Thu Nov 12 11:00:00 2026 +0900

    ログイン画面を作る
    
    - ログイン画面を追加
    - パスワード欄を追加
    - ログインボタンを追加

 login.txt | 3 +++
 1 file changed, 3 insertions(+)

$ git log -1 --format="親: %p"
親: f52ca5e

main には 24dd358 が1つ増えただけです。親は main の f52ca5e の1つだけで、普通のマージのように2本の線が合流するマージコミットにはなりません。feature の3つのコミットは feature ブランチに残ったまま、main の履歴には入っていません。

ポイント

git merge --squash がするのは変更をステージするところまでで、コミットは自分で git commit を実行して作ります。メッセージは SQUASH_MSG のままにせず、何をしたかが分かる件名に書き換えると、main の履歴が読みやすくなります。

コミットする前にやめたいときは git reset –merge

git merge --squash の後、コミットせずに取り込む前へ戻したいときに git merge --abort を実行すると、エラーになりました。MERGE_HEAD がないので、Git はマージの途中だと見なしません。

console
$ git merge --abort
fatal: There is no merge to abort (MERGE_HEAD missing).

$ git reset --merge

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

$ ls .git/SQUASH_MSG
ls: cannot access '.git/SQUASH_MSG': No such file or directory

git reset --merge を実行すると、ステージされた変更が消えて取り込む前の状態に戻り、SQUASH_MSG も消えました。git merge の公式リファレンスにも、MERGE_HEAD があるときの git merge --abort は git reset --merge と同じ動きだと書かれています。git reset の公式リファレンスによると、--merge はステージしていない手元の変更を残す戻し方です。ただし、取り込んでステージされたファイルを、さらに手で書き換えていると、reset は中止されます。

取り込んだブランチを消すには -D が要る

取り込みが終わった feature を git branch -d で消そうとすると、断られました。

console
$ git branch -d feature
error: the branch 'feature' is not fully merged.
If you are sure you want to delete it, run 'git branch -D feature'

$ git branch --merged
* main

$ git log --oneline main..feature
6cc4aad ログインボタンを追加
6e59ecd パスワード欄を追加
d106d3d ログイン画面を追加

$ git diff main feature --stat
 README.md | 2 --
 1 file changed, 2 deletions(-)

-d は、上流ブランチ(upstream)を設定していればそのブランチに、設定していなければ HEAD に取り込み済みのときだけブランチを消します(git branch の公式リファレンス)。--squash で作ったコミットは feature のコミットとは別物なので、Git から見ると feature の3つのコミットは main に入っていません。git branch --merged にも feature は出ず、git log main..feature には3つとも残っています。

中身が main に入ったかは、git diff main feature --stat で確かめられます。差として出たのは、main 側で変えた README.md だけでした。feature で足した login.txt は差に出ないので、中身は main に入っています。確かめたうえで、-D で消します。

console
$ git branch -D feature
Deleted branch feature (was 6cc4aad).
注意

git branch -D は、取り込み済みかどうかを確かめずにブランチを消します。--squash の後は -d が使えないので、ブランチ名を打ち間違えると、取り込んでいないブランチまで消えてしまいます。消す前に、上の git diff で確かめておくと安心です。

コンフリクトしたとき

main と取り込むブランチで同じ行を変えていると、--squash でもコンフリクトします。docs ブランチで README の説明を「共有するアプリ」に直し、main では同じ行を「整理するアプリ」に変えてから取り込みました。

console
$ git merge --squash docs
Auto-merging README.md
CONFLICT (content): Merge conflict in README.md
Squash commit -- not updating HEAD
Automatic merge failed; fix conflicts and then commit the result.

$ git status
On branch main
Unmerged paths:
  (use "git restore --staged <file>..." to unstage)
  (use "git add <file>..." to mark resolution)
	both modified:   README.md

no changes added to commit (use "git add" and/or "git commit -a")

$ cat README.md
# 猫の手アプリ

<<<<<<< HEAD
猫の写真を集めて整理するアプリです。
=======
猫の写真を集めて共有するアプリです。

## 使い方
>>>>>>> docs

直し方は普通のマージと同じです。ファイルを望む内容に書き直し、git add してから git commit します。

console
$ printf "# 猫の手アプリ\n\n猫の写真を集めて整理・共有するアプリです。\n\n## 使い方\n" > README.md

$ git add README.md

$ git status
On branch main
Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
	modified:   README.md

$ git commit
----- エディターに渡された内容 -----
Squashed commit of the following:

commit 09af33a209acd9b3e5c6d9c3db21139702108cdf
Author: Neko <neko@example.com>
Date:   Thu Nov 12 11:30:00 2026 +0900

    使い方の見出しを追加

commit 85826ccc9770924813ad4b4387a83f0b05fa2ac5
Author: Neko <neko@example.com>
Date:   Thu Nov 12 11:20:00 2026 +0900

    READMEの説明を直す

# Conflicts:
#	README.md

# Please enter the commit message for your changes. Lines starting
# with '#' will be ignored, and an empty message aborts the commit.
#
# On branch main
# Changes to be committed:
#	modified:   README.md
#
----- ここまで(次の内容に書き換えて保存して閉じる) -----
READMEの説明を直し、使い方の見出しを追加
[main 0d7b8f1] READMEの説明を直し、使い方の見出しを追加
 1 file changed, 3 insertions(+), 1 deletion(-)

$ git log --oneline -3
0d7b8f1 READMEの説明を直し、使い方の見出しを追加
5d873e4 READMEの説明を変える
24dd358 ログイン画面を作る

$ git log -1 --format="親: %p"
親: 5d873e4

エディターには、取り込んだコミットのメッセージに加えて、# Conflicts: とコンフリクトしたファイルの名前が入っていました。# で始まる行はメッセージに残りません。コンフリクトを直した場合も、できるのは親が1つのコミットです。

同じブランチをもう一度取り込むと、同じところでぶつかる

docs を消さずに続きの作業をし、もう一度 --squash で取り込んでみました。docs には「使い方を書く」のコミットを1つ足しただけです。

console
$ git merge --squash docs
Auto-merging README.md
CONFLICT (content): Merge conflict in README.md
Squash commit -- not updating HEAD
Automatic merge failed; fix conflicts and then commit the result.

$ cat README.md
# 猫の手アプリ

<<<<<<< HEAD
猫の写真を集めて整理・共有するアプリです。

## 使い方
=======
猫の写真を集めて共有するアプリです。

## 使い方

写真を選んで送ります。
>>>>>>> docs

$ git log --oneline main..docs
70223e8 使い方を書く
09af33a 使い方の見出しを追加
85826cc READMEの説明を直す

1回目にコンフリクトを直した行で、またコンフリクトしました。git log main..docs を見ると、1回目に取り込んだ2つのコミットも、まだ main に入っていないものとして並んでいます。main と docs の共通の祖先を git merge-base で調べると、docs を作った時点の 24dd358 のままでした。

console
$ git merge-base main docs
24dd3580641116faa12f66b381189b6c632e9ade

$ git log --oneline -1 $(git merge-base main docs)
24dd358 ログイン画面を作る

--squash で作ったコミットは docs のコミットを親に持たないので、共通の祖先は変わりません。そのため2回目も、docs を作った時点からの変更を全部取り込み直します。GitHub の「Squash and merge」の説明にも、取り込んだ後のブランチで作業を続けると、取り込み済みのコミットが次のプルリクエストにも並び、同じコンフリクトを何度も直すことになる場合があると書かれています。--squash で取り込んだブランチは、そこで使い終えるつもりで扱うと迷いません。続きの作業は、更新した main から新しくブランチを作って始めます。

ここでは git reset --merge で取り込む前に戻しました。git status --short が何も出さないので、変更は残っていません。

console
$ git reset -q --merge

$ git status --short

main が進んでいないときと、–no-ff を付けたとき

取り込む側の main がブランチを作ったときから進んでいないと、出力が少し変わります。Fast-forward と出ますが、--squash なのでこの場合も main は動かず、変更がステージされるだけです。

console
$ git merge --squash topic
Updating 24dd358..439508a
Fast-forward
Squash commit -- not updating HEAD
 settings.txt | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 settings.txt

$ git log --oneline -1
24dd358 ログイン画面を作る

$ git status --short
A  settings.txt

main の最新のコミットは 24dd358 のままで、settings.txt がステージされています。

--squash は、早送りできる場合でもマージコミットを作る --no-ff(公式リファレンスの –no-ff の説明)とは、一緒に使えませんでした。

console
$ git merge --squash --no-ff topic
fatal: options '--squash' and '--no-ff.' cannot be used together

細かいコミットを main に入れる前に、ブランチの中で整理しておきたいときは、git rebase -i で作業ブランチのコミットをまとめる方法もあります。--squash はブランチ側の履歴には手を付けず、取り込む側に1つのコミットを作る方法です。

​Posted by 86