Gitのrebase -iで、複数のコミットを1つにまとめる方法

​​Git​コマンドライン

作業の途中で「誤字を直す」「写真を追加」のような細かいコミットが続いたときは、git rebase -i の squash で1つのコミットにまとめられます。プルリクエストを出す前やレビューを頼む前に、履歴を読みやすく整えたいときに使う操作です。todo リストの書き換え方、メッセージのまとめ方、メッセージを残さない fixup、あとで自動でまとめる --autosquash、まとめたあとのやり直し方を、検証環境での実際の出力で見ていきます。

補足

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

まとめる前の履歴

プロフィールページを作る途中で、最初のコミットの上に、次の4つのコミットができた状態から始めます。いちばん下の「最初のコミット」は残し、その上の4つを「プロフィールページを追加」1つにまとめます。

console
$ git log --oneline
a78c54d 写真を追加
1978f6c 誤字を直す
9dd8530 自己紹介を書く
2f3d332 プロフィールページを追加
1255800 最初のコミット

git rebase -i HEAD~4 で todo リストを開く

まとめたいコミットが新しいほうから4つなので、git rebase -i HEAD~4 を実行します。HEAD~4 は「4つ前のコミット」(ここでは 1255800)を指し、それより後のコミットが対象になります。エディターには、次のような todo リストが開きます(# で始まる説明の行は、途中を省いています)。

console
$ git rebase -i HEAD~4
pick 2f3d332 プロフィールページを追加
pick 9dd8530 自己紹介を書く
pick 1978f6c 誤字を直す
pick a78c54d 写真を追加

# Rebase 1255800..a78c54d onto 1255800 (4 commands)
#
# Commands:
# p, pick <commit> = use commit
# r, reword <commit> = use commit, but edit the commit message
# e, edit <commit> = use commit, but stop for amending
# s, squash <commit> = use commit, but meld into previous commit
# f, fixup [-C | -c] <commit> = like "squash" but keep only the previous
#                    commit's log message, unless -C is used, in which case
#                    keep only this commit's message; -c is same as -C but
#                    opens the editor
(中略)
# These lines can be re-ordered; they are executed from top to bottom.
#
# If you remove a line here THAT COMMIT WILL BE LOST.
(後略)

todo リストは git log --oneline と並びが逆で、上が古いコミットです。上から順に実行されます。

まとめるには、残す1行目は pick のまま、2行目から下の pick を squash(短く s でも可)に書き換えて、保存して閉じます。squash は「1つ上のコミットにまとめる」という指示です(git rebase の公式リファレンスにある、コミットをまとめる手順)。

text
pick 2f3d332 プロフィールページを追加
squash 9dd8530 自己紹介を書く
squash 1978f6c 誤字を直す
squash a78c54d 写真を追加
注意

todo リストから行を消すと、そのコミットは消えます(説明の行にも If you remove a line here THAT COMMIT WILL BE LOST. とあります)。まとめたいコミットの行は消さずに、pick を squash に書き換えます。

まとめたあとのコミットメッセージを書く

todo リストを閉じると、続けてコミットメッセージ用のエディターが開きます。4つのコミットのメッセージが、上から順に並んだ状態で渡されました。

console
# This is a combination of 4 commits.
# This is the 1st commit message:

プロフィールページを追加

# This is the commit message #2:

自己紹介を書く

# This is the commit message #3:

誤字を直す

# This is the commit message #4:

写真を追加

# Please enter the commit message for your changes. Lines starting
# with '#' will be ignored, and an empty message aborts the commit.
#
# Date:      Wed Nov 11 10:10:00 2026 +0900
(後略)

# で始まる行はメッセージに入りません。このままでは4つのメッセージを並べたものになるので、残したい形に書き直します。検証では、次のメッセージに置き換えて保存しました。

text
プロフィールページを追加

写真と自己紹介を載せる

保存して閉じると、rebase が最後まで進みます。

console
[detached HEAD 9729791] プロフィールページを追加
 Date: Wed Nov 11 10:10:00 2026 +0900
 1 file changed, 3 insertions(+)
 create mode 100644 profile.html

Successfully rebased and updated refs/heads/main.

まとめたあとの履歴と中身を確かめる

4つのコミットが1つになり、ハッシュは新しい 9729791 になりました。

console
$ git log --oneline
9729791 プロフィールページを追加
1255800 最初のコミット
squash の前は最初のコミットの上に4つのコミットが並び、後は最初のコミットの上に 9729791 の1つだけがある
squash の前と後の履歴。上の4つが1つのコミットになる

--format=fuller で見ると、作者の日時(AuthorDate)は10:10のままです。これは、todo リストのいちばん上で pick のまま残した「プロフィールページを追加」を作った日時です。コミットした日時(CommitDate)は、rebase を実行した11:00になっています。メッセージは、エディターで書き直したものです。

console
$ git log -1 --format=fuller
commit 972979110edc2847cd951b0bb8ce63934d74a3f4
Author:     Neko <neko@example.com>
AuthorDate: Wed Nov 11 10:10:00 2026 +0900
Commit:     Neko <neko@example.com>
CommitDate: Wed Nov 11 11:00:00 2026 +0900

    プロフィールページを追加
    
    写真と自己紹介を載せる

検証では、まとめる前に git tag before-squash で、ブランチの最新のコミット(a78c54d)にタグを付けておきました。まとめる前と後で git diff を取ると、何も出ません。履歴の分け方が変わっただけで、ファイルの中身は同じです。

console
$ git diff before-squash HEAD

$ cat profile.html
<h1>プロフィール</h1>
<img src="neko.png" alt="猫">
<p>自己紹介</p>

まとめる前に戻すときは ORIG_HEAD を使う

rebase を始めると、始める前のブランチの最新のコミットが ORIG_HEAD に記録されます(git rebase の公式リファレンス)。まとめ方を間違えたと気づいたら、すぐに git reset --hard ORIG_HEAD で戻せます。

console
$ git log --oneline -1 ORIG_HEAD
a78c54d 写真を追加

$ git reset --hard ORIG_HEAD
HEAD is now at a78c54d 写真を追加

$ git log --oneline
a78c54d 写真を追加
1978f6c 誤字を直す
9dd8530 自己紹介を書く
2f3d332 プロフィールページを追加
1255800 最初のコミット

git reset --hard は、Git が追跡しているファイルの、コミットしていない変更を捨てます(git reset の公式リファレンス)。戻す前に git status で、残したい変更がないかを確かめてください。

メッセージを残さずにまとめる fixup

「誤字を直す」のように、メッセージを残す必要のないコミットは、squash の代わりに fixup(短く f)にします。fixup にしたコミットのメッセージは捨てられ、1つ上の pick のメッセージだけが残ります(git rebase の公式リファレンス)。

text
pick 2f3d332 プロフィールページを追加
fixup 9dd8530 自己紹介を書く
fixup 1978f6c 誤字を直す
fixup a78c54d 写真を追加

この todo リストで実行すると、メッセージ用のエディターは開かずに最後まで進みました。

console
Successfully rebased and updated refs/heads/main.

$ git log --oneline
8e94b10 プロフィールページを追加
1255800 最初のコミット

$ git show --stat --format=%B HEAD
プロフィールページを追加


 profile.html | 3 +++
 1 file changed, 3 insertions(+)

squash のときと中身は同じですが、メッセージが違うので、ハッシュは 8e94b10 と別のものになります。検証では、このあと git reset --hard before-squash で、まとめる前の5つのコミットに戻しています。

直すコミットを先に作り、–autosquash でまとめる

直したいコミットのあとに、別のコミットが入ることもあります。次の履歴では、「好きなもの」の書き方を「かつおぶし」から「かつお節」に直したいのですが、そのあとに「連絡先ページを追加」が入っています。

console
$ git log --oneline
7dc8cf5 連絡先ページを追加
7a2cf85 好きなものを追加
a78c54d 写真を追加
1978f6c 誤字を直す
9dd8530 自己紹介を書く
2f3d332 プロフィールページを追加
1255800 最初のコミット

直した変更は、git commit --fixup=<直したいコミット> でコミットします。ここでは1つ前の「好きなものを追加」なので、HEAD~1 を指定しました。メッセージが fixup! 好きなものを追加 のコミットができます。

console
$ sed -i 's/かつおぶし/かつお節/' profile.html

$ git add profile.html

$ git commit --fixup=HEAD~1
[main a1f679a] fixup! 好きなものを追加
 1 file changed, 1 insertion(+), 1 deletion(-)

あとで git rebase -i --autosquash を実行すると、fixup! のコミットが、まとめ先のコミットのすぐ下に移り、fixup に書き換わった状態で todo リストが開きます(–autosquash の説明)。

console
$ git rebase -i --autosquash HEAD~4
pick a78c54d 写真を追加
pick 7a2cf85 好きなものを追加
fixup a1f679a fixup! 好きなものを追加
pick 7dc8cf5 連絡先ページを追加
(後略)

元の並びでは「連絡先ページを追加」の上にあった a1f679a が、「好きなものを追加」のすぐ下に移っています。自分で行を並べ替えて書き換える手間がありません。このまま閉じると、「好きなものを追加」に直した変更が入り、fixup! のコミットはなくなりました。

console
$ git log --oneline
5b94894 連絡先ページを追加
27cc2bf 好きなものを追加
a78c54d 写真を追加
1978f6c 誤字を直す
9dd8530 自己紹介を書く
2f3d332 プロフィールページを追加
1255800 最初のコミット

$ git show --format=%s HEAD~1
好きなものを追加

diff --git a/profile.html b/profile.html
index 69a4c8b..5ba3022 100644
--- a/profile.html
+++ b/profile.html
@@ -1,3 +1,4 @@
 <h1>プロフィール</h1>
 <img src="neko.png" alt="猫">
 <p>自己紹介</p>
+<p>好きなもの:かつお節</p>

メッセージも残したいときは、--fixup の代わりに --squash=<コミット> を使うと squash! で始まるコミットができ、--autosquash で squash として並びます(git commit の –squash の説明と、git rebase の –autosquash の説明)。

最初のコミットまで含めるときは –root

HEAD~N は、さかのぼれるコミットの数を超えると使えません。上の履歴はコミットが7つなので、HEAD~7 は存在せず、エラーになりました。

console
$ git rebase -i HEAD~7
fatal: invalid upstream 'HEAD~7'

最初のコミットも todo リストに入れたいときは、--root を付けます(–root の説明)。todo リストの1行目に「最初のコミット」が出ました。

console
$ git rebase -i --root
pick 1255800 最初のコミット
pick 2f3d332 プロフィールページを追加
pick 9dd8530 自己紹介を書く
pick 1978f6c 誤字を直す
pick a78c54d 写真を追加
pick 27cc2bf 好きなものを追加
pick 5b94894 連絡先ページを追加
(後略)

ここでは pick のまま閉じたので、履歴は変わっていません。

rebase の途中で止まったら –abort で始める前に戻る

todo リストに edit を書いたときや、コミットをまとめる途中で変更がぶつかったときは、rebase が途中で止まります(git rebase の公式リファレンス)。止まった状態は git status で分かります。

console
$ git status
interactive rebase in progress; onto a78c54d
Last command done (1 command done):
   edit 27cc2bf 好きなものを追加
Next command to do (1 remaining command):
   pick 5b94894 連絡先ページを追加
(後略)

ここで git rebase --abort を実行すると、rebase を始める前のブランチに戻りました。

console
$ git rebase --abort

$ git log --oneline -1
5b94894 連絡先ページを追加

$ git status --short --branch
## main

まとめたコミットは、すべて新しいハッシュのコミットに作り直されます。Pro Git 日本語版の「歴史の書き換え」では、共有のリポジトリにプッシュしたコミットは rebase の対象に含めないように、と注意しています。

​Posted by 86