git format-patchとamで、コミットをファイルで渡す方法

​​Git​コマンドライン

git format-patch main を実行すると、main にないコミットが1つずつパッチファイル(.patch)になります。受け取った側は git am でそのファイルを読み込むと、コミットメッセージと作者の名前・日時をそのまま保ったコミットとして取り込めます。同じリモートリポジトリにプッシュできない相手に、メールの添付やファイルの受け渡しで変更を送りたいときに使える方法です。検証環境で実際にコマンドを実行し、操作の前と後の出力をそのまま載せています。

補足

検証環境は Ubuntu 24.04、Git 2.43.0 です。送る側のリポジトリ(neko-app)の作者は Neko <neko@example.com>、受け取る側でコミットする人は Tama <tama@example.com> という例示用の値にし、コミットの日時は環境変数で決めています。受け取る側のリポジトリは、送る側に「最初のコミット」だけがある時点で git clone して作りました。git send-email でメールを送る使い方、Windows と macOS での動作は試していません。

送る側のコミット

送る側の neko-app では、main から feature ブランチを作り、コミットを2つ積みました。1つ目のコミットには、件名の下に説明の本文も書いています。

console
$ git switch -q -c feature

$ printf "console.log(\"にゃーにゃー\");\n" > src/main.js

$ git commit -q -am "鳴き声を2回にする" -m "朝のあいさつ用に、鳴き声を2回にしました。"

$ printf "# 猫の手アプリ\n\n猫が鳴くだけのアプリです。\n" > README.md

$ git commit -q -am "READMEに説明を足す"

$ git log --oneline main..feature
dec1670 READMEに説明を足す
da2a938 鳴き声を2回にする

この2つを、受け取る側に渡します。

git format-patch でパッチファイルを作る

feature ブランチにいる状態で、git format-patch に main を渡します。git format-patch の公式リファレンスによると、コミットを1つだけ書いたときは、今のブランチのうち、そのコミットの履歴に入っていないコミットがパッチになります。

console
$ git format-patch main
0001-2.patch
0002-README.patch

コミット1つにつき1つのファイルができ、作ったファイルの名前が表示されました。ファイル名は、通し番号とコミットメッセージの1行目からできています。ただ、1行目が「鳴き声を2回にする」のコミットは 0001-2.patch に、「READMEに説明を足す」のコミットは 0002-README.patch になりました。ファイル名に使える文字に直すときに、日本語の部分が落ちています。日本語のコミットメッセージでは、ファイル名から中身の見当がつかないことがあります。

1つ目のファイルの中身です。

console
$ cat 0001-*.patch
From da2a93865c6336e751771b888fdd7b8701cdf12a Mon Sep 17 00:00:00 2001
From: Neko <neko@example.com>
Date: Thu, 12 Nov 2026 10:30:00 +0900
Subject: [PATCH 1/2] =?UTF-8?q?=E9=B3=B4=E3=81=8D=E5=A3=B0=E3=82=922?=
 =?UTF-8?q?=E5=9B=9E=E3=81=AB=E3=81=99=E3=82=8B?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

朝のあいさつ用に、鳴き声を2回にしました。
---
 src/main.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/main.js b/src/main.js
index e1b4fab..57c9422 100644
--- a/src/main.js
+++ b/src/main.js
@@ -1 +1 @@
-console.log("にゃー");
+console.log("にゃーにゃー");
-- 
2.43.0

メールと同じ形をしたテキストファイルです。上から順に、次のことが書かれています。

  • 1行目:元のコミットの ID。日付の Mon Sep 17 00:00:00 2001 は、どのパッチでも同じ固定の値です
  • From: と Date::コミットの作者と、作者がコミットした日時
  • Subject::[PATCH 1/2] と、コミットメッセージの1行目。日本語は =?UTF-8?q?…?= の形に変換されています
  • 空行の下から --- まで:コミットメッセージの本文
  • --- の下:変更したファイルの一覧と差分
  • 最後の -- の下:作った Git のバージョン(署名)

公式リファレンスの説明にも、固定の日付は file コマンドなどのプログラムがファイルを format-patch の出力だと見分けられるようにするためのもので、メッセージと差分は --- の行で区切ると書かれています。最後の署名は、–signature の説明のとおり、指定しなければ Git のバージョンになります。

出力先のフォルダーを -o で決める

何も指定しないと、パッチファイルは今いるフォルダーにできます。リポジトリの中に作ると、Git の管理に入れていないファイルとして git status に出てきます。

console
$ git status --short
?? 0001-2.patch
?? 0002-README.patch

うっかりコミットしないように、-o で出力先のフォルダーを指定すると扱いやすくなります。ここでは一度ファイルを消し、リポジトリの1つ上の patches フォルダーに作り直しました。フォルダーがなくても作られます。

console
$ rm 000*.patch

$ git format-patch -o ../patches main
../patches/0001-2.patch
../patches/0002-README.patch

1つのコミットだけ、または1つのファイルにまとめる

特定のコミットを1つだけパッチにしたいときは、-1 とコミットを指定します。HEAD~1(1つ前のコミット)を渡すと、「鳴き声を2回にする」だけがパッチになりました。

console
$ git format-patch -1 HEAD~1 -o ../one
../one/0001-2.patch

--stdout を付けると、ファイルに分けずに標準出力へまとめて書き出します。リダイレクトで1つのファイルにすると、添付するファイルが1つで済みます。

console
$ git format-patch --stdout main > ../all.patch

$ grep -c "^From [0-9a-f]\{40\} " ../all.patch
2

From とコミットの ID で始まる行が2つあり、2つのコミットが1つのファイルに入っています。

git am で受け取る側に取り込む

受け取る側のリポジトリは、コミットが「最初のコミット」の1つだけで、作業中の変更もない状態です。

console
$ git log --oneline
2d8f2f7 最初のコミット

$ git status --short

受け取ったパッチファイルを、番号の順に git am に渡します。../patches/*.patch のように書くと、ファイル名の順(0001、0002 の順)に渡せます。

console
$ git am ../patches/*.patch
Applying: 鳴き声を2回にする
Applying: READMEに説明を足す

$ git log --oneline
8f7bd8e READMEに説明を足す
df98d68 鳴き声を2回にする
2d8f2f7 最初のコミット

コミットが2つ増えました。件名には [PATCH 1/2] が付かず、日本語も元どおりに戻っています。ファイルの中身も、送る側と同じになりました。

console
$ cat src/main.js README.md
console.log("にゃーにゃー");
# 猫の手アプリ

猫が鳴くだけのアプリです。

作者は送った人、コミットした人は受け取った人になる

git log --format=fuller で、作者(Author)とコミットした人(Commit)を分けて表示しました。

console
$ git log -2 --format=fuller
commit 8f7bd8ebee48cb37dd68eb2799b1d417dce4a2a7
Author:     Neko <neko@example.com>
AuthorDate: Thu Nov 12 10:40:00 2026 +0900
Commit:     Tama <tama@example.com>
CommitDate: Thu Nov 12 11:00:00 2026 +0900

    READMEに説明を足す

commit df98d6800045125aef7a6708122b391bca5dfe69
Author:     Neko <neko@example.com>
AuthorDate: Thu Nov 12 10:30:00 2026 +0900
Commit:     Tama <tama@example.com>
CommitDate: Thu Nov 12 11:00:00 2026 +0900

    鳴き声を2回にする
    
    朝のあいさつ用に、鳴き声を2回にしました。

作者は送る側の Neko で、日時もパッチの Date: と同じ 10:30 と 10:40 です。コミットした人は、取り込んだ受け取る側の Tama になり、日時は取り込んだときの 11:00 でした。コミットメッセージの本文も残っています。git am の公式リファレンスにも、作者の名前は From: の行から、作者の日時は Date: の行から、コミットメッセージの件名は Subject: から [PATCH …] を除いて取ると書かれています。

ポイント

git am で取り込んだコミットは、送る側のコミットと ID が変わります。送る側の da2a938 は、受け取る側では df98d68 になりました。変更の中身が同じでも、Git では別のコミットになります。

パッチが当てられずに止まったとき

受け取る側で、同じ行を先に書き換えていた場合を試しました。別に用意した受け取る側のリポジトリで、src/main.js を「ニャッ」に変えてコミットしてから、同じパッチを git am に渡しています。

console
$ git log --oneline
f3e664c 鳴き声を短くする
2d8f2f7 最初のコミット

$ git am ../patches/*.patch
error: patch failed: src/main.js:1
error: src/main.js: patch does not apply
hint: Use 'git am --show-current-patch=diff' to see the failed patch
Applying: 鳴き声を2回にする
Patch failed at 0001 鳴き声を2回にする
When you have resolved this problem, run "git am --continue".
If you prefer to skip this patch, run "git am --skip" instead.
To restore the original branch and stop patching, run "git am --abort".

1つ目のパッチで止まりました。このとき git status を見ると、git am の途中であることが表示されます。一方で、ファイルには何も書き込まれず、コミットも増えていません。

console
$ git status
On branch main
Your branch is ahead of 'origin/main' by 1 commit.
  (use "git push" to publish your local commits)

You are in the middle of an am session.
  (fix conflicts and then run "git am --continue")
  (use "git am --skip" to skip this patch)
  (use "git am --abort" to restore the original branch)

nothing to commit, working tree clean

$ git log --oneline
f3e664c 鳴き声を短くする
2d8f2f7 最初のコミット

git am –abort で取り込みをやめる

git am --abort を実行すると、git am を始める前の状態に戻ります。

console
$ git am --abort

$ git status --short

$ git log --oneline
f3e664c 鳴き声を短くする
2d8f2f7 最初のコミット

-3 を付けて、競合を直してから続ける

git am に -3(--3way)を付けると、そのまま当てられないパッチを3-way マージで取り込もうとします。公式リファレンスの -3 の説明によると、パッチに書かれた元のファイル(差分の index の行にある ID)が手元のリポジトリにあるときに使えます。今回は送る側を clone して作ったリポジトリなので、元のファイルが手元にあります。

console
$ git am -3 ../patches/*.patch
Applying: 鳴き声を2回にする
Using index info to reconstruct a base tree...
M	src/main.js
Falling back to patching base and 3-way merge...
Auto-merging src/main.js
CONFLICT (content): Merge conflict in src/main.js
error: Failed to merge in the changes.
hint: Use 'git am --show-current-patch=diff' to see the failed patch
Patch failed at 0001 鳴き声を2回にする
When you have resolved this problem, run "git am --continue".
If you prefer to skip this patch, run "git am --skip" instead.
To restore the original branch and stop patching, run "git am --abort".

$ cat src/main.js
<<<<<<< HEAD
console.log("ニャッ");
=======
console.log("にゃーにゃー");
>>>>>>> 鳴き声を2回にする

今度は、git merge で競合したときと同じように、ファイルに <<<<<<< から >>>>>>> までの行が入りました。ファイルを直したい内容にしてから git add し、git am --continue で続けます。

console
$ printf "console.log(\"ニャッ ニャッ\");\n" > src/main.js

$ git add src/main.js

$ git am --continue
Applying: 鳴き声を2回にする
Applying: READMEに説明を足す

$ git log --oneline
cb3374e READMEに説明を足す
a814ecd 鳴き声を2回にする
f3e664c 鳴き声を短くする
2d8f2f7 最初のコミット

$ git log -1 --format="%an <%ae> / %cn <%ce>" HEAD~1
Neko <neko@example.com> / Tama <tama@example.com>

手で直した内容で1つ目のコミットができ、残りの「READMEに説明を足す」も続けて取り込まれました。手で直したコミットでも、作者は Neko のままです。そのパッチを取り込まずに次へ進みたいときは、--continue の代わりに git am --skip を使います。

git apply では、コミットにならない

同じパッチファイルは git apply でも当てられます。ただし、変わるのはファイルだけで、コミットは作られません。ここでは、リポジトリが並んでいる1つ上のフォルダーで送る側を新しく clone し、main に切り替えてから当てました。

console
$ git clone -q neko-app apply-test && cd apply-test && git switch -q main && git apply ../patches/0001-*.patch && git status --short && git log --oneline
 M src/main.js
2d8f2f7 最初のコミット

src/main.js が変更された状態になっただけで、コミットは「最初のコミット」のままです。コミットメッセージや作者の情報は使われません。git apply の公式リファレンスでも、git apply はコミットを作らず、format-patch で作ったパッチからコミットを作るには git am を使うよう案内されています。差分だけを試しに当てて中身を見たいときは git apply、コミットとして受け取りたいときは git am と使い分けます。

​Posted by 86