【Git】git diff patch を使った差分管理の方法を初心者向けに解説

Web開発•2025/2/21

Git

はじめに

Gitを使った開発現場では、複数人で同じリポジトリを操作することが多いです。

このとき、どこが変更されているのか を正確に把握したり、特定の変更だけを取り込む 必要が出てくる場合があります。

そこで便利な手段となるのが git diff で作成する patchファイル の活用です。

変更点をファイルとして書き出すことができるため、ほかの開発メンバーと差分をやり取りしたり、一部の修正だけを後から取り込みたいときにとても役立ちます。

皆さんも、開発の途中で「この修正だけは先にレビューしてほしい」「ブランチをまたぐコミットを簡単に共有したい」という場面に遭遇することがあるかもしれません。

そうした状況では、git diff patch が強い味方になってくれるでしょう。

この記事を読むとわかること

git diff patch の基本的な概要
パッチファイルの作成から適用までの流れ
実務で役立つ差分管理の具体例
よくあるトラブルの対処方法
変更の取り込みで気をつけたいポイント

git diff patch とは何か？

Gitでは、差分 (diff) と呼ばれる情報を確認して、何がどのように変更されたかを追跡できます。

この差分をファイル形式で書き出したものが patchファイル です。

patchファイルを作ることで、特定の変更内容をまとめて別のブランチに適用したり、レビュー用に共有することができます。

たとえば、以下のようなシーンで役立つことが多いです。

コミットせずにローカルで試作した修正を、別の作業環境へ渡したい
重要な差分だけを取り出して、一部のブランチに取り込みたい
レビュー担当者に「この差分だけ見てほしい」と依頼したい

こうした場合にパッチファイルがあると、メールやチャットなどで手軽に差分を送ったり、別の作業場所で適用するといった使い方ができます。

Gitには便利なサブコマンドがいくつも存在しますが、特に git diff と git apply をセットで覚えておくと、差分管理がスムーズになります。

patchファイルを作成するメリット

Gitリポジトリの中では、ブランチを切ってプルリクエストを作成したり、他のメンバーにレビューを依頼するのが一般的です。

しかし、状況によってはブランチを活用しにくいこともあるかもしれません。

また、クライアントなどに一時的な変更内容を確認してもらう際にも、必ずしもリポジトリごと渡すわけにはいかない場合があります。

そうしたとき、patchファイル は次のような利点をもたらします。

1. メールやチャットでも送れる

Gitリポジトリ全体を渡すよりもファイルサイズが小さく、気軽に送付しやすいです。

2. 特定の変更点だけを抽出できる

いくつもの変更が混在している状況でも、必要な差分だけを取り出してパッチ化できます。

3. 適用作業がスムーズ

受け取った人は git apply コマンドを使うだけで、同じ差分を自分のローカル環境へ取り込めます。

4. レビューがしやすい

シンプルなテキストファイルなので、Git以外のツールでも差分を確認できます。

patchファイルは、いわば「差分を記録した特別なテキストファイル」なので、利用シーンを選ばずに扱えるのが特徴です。

実務で役立つ git diff patch の基本的な使い方

git diff で差分を確認する

まず、通常の差分確認方法として git diff を使うケースを考えましょう。

変更されているファイルをまだコミットしていないなら、単に git diff と入力するだけでOKです
すでにコミットされた差分を確認するときは、git diff コミットID1 コミットID2 のように指定します

以下は、あるコミットとその一つ前のコミットを比較したい例です。


git diff HEAD^ HEAD

このように入力すると、HEAD^（1つ前のコミット）とHEAD（最新コミット）の差分が標準出力に表示されます。

こうして普段の開発で差分確認を行っている方も多いかもしれません。

しかし、これだけだと標準出力に情報が並ぶだけなので、他の人とやり取りするには不便ですよね。

そこで次に紹介するのが、git diff を使って差分を「ファイル」として取り出す方法です。

patchファイルを作成する

今度は以下のようにコマンドを実行してみましょう。


git diff HEAD^ HEAD > changes.patch

ここでは、差分を changes.patch というファイルに書き出しています。

すると、ローカルフォルダに patchファイルが生成され、差分情報が詰まったテキストデータを確認できるようになります。

誰かにこの changes.patch ファイルを渡せば、同じ変更を取り込んでもらえるようになるわけです。

もし比較したいコミットが別々のブランチにある場合は、git diff ブランチA ブランチB > some_branch.patch のように書き出すことも可能です。

patchファイルを適用する

次に、そのパッチファイルを受け取った人が変更を取り込むには、以下のように git apply を使います。


git apply changes.patch

これだけで、patchファイルに記載された差分がローカルのコードに反映されます。

同じプロジェクトのリポジトリ内であれば、ほとんどの場合はこれだけで問題なく動作します。

ただし、すでに一部の変更が取り込まれていたり、ファイル名が変わっている場合などはコンフリクトが発生することがあります。

そういったときは、通常の差分コンフリクトのように手動で調整する必要があります。

複数コミット間の差分をまとめる

特定のブランチ内で、複数のコミットをまとめてパッチにしたいときもあるでしょう。

たとえば、直近3つのコミットをまとめたいなら、こんな具合に指定できます。


git diff HEAD~3 HEAD > multi.patch

HEAD~3 は、現在のコミットから3つ前のコミットを表しています。

これで、3つぶんの変更点がまるごと multi.patch に記載されるため、一度に取り込んでもらうことが可能になります。

複数の差分をまとめるか、単一のコミットだけを取り出すか、シーンに応じて使い分けてください。

実際の使用例

シンプルなシナリオ

たとえば、以下のような流れで作業したケースを想定します。

ローカルブランチでファイルを編集し、コミットを行う
バグ修正だけを抜き出して、別のブランチに先行取り込みしたい
そのバグ修正をパッチファイルにして、チームメンバーに送る

実際には、ターミナルで以下の手順を踏みます。


# コミットした変更を確認
git log --oneline

# 先行して取り込みたいコミットのIDを確認
# （例: コミットIDが abc123 の場合）

git diff abc123^ abc123 > bugfix.patch

こうして作成した bugfix.patch を受け取ったメンバーは、別のブランチで適用します。


# 別ブランチへ切り替えた後にパッチを適用
git apply bugfix.patch

これにより、バグ修正だけが抽出され、別ブランチへスムーズに反映されます。

パッチファイルにはコミットメッセージやコミット履歴そのものは含まれません。
あくまで「差分情報」を適用している点を覚えておきましょう。

コミット履歴も含めたい場合

もしコミットメッセージや履歴ごとまとめて別のブランチへ取り込みたい場合は、git format-patch と git am の組み合わせを使う方法もあります。

しかし、初心者には少しハードルが高く感じられるかもしれません。

まずは git diff でのパッチ作成と git apply を習得し、差分管理の便利さを体験すると良いでしょう。

トラブルシューティング

コンフリクトが起きる

パッチを適用した際に、ローカルファイルと差分内容が衝突してエラーになることがあります。

すでに一部の変更が手作業で加えられている
ファイル名が変更されている
該当箇所がすでに別の修正で書き換えられた

こうした場合は、Gitが自動的にコンフリクトを検出してパッチ適用を停止します。

解決策は、通常のマージコンフリクトと同じです。

ファイルの衝突箇所を手動で修正し、再度コミットを行うことで解消できます。

改行コードの違いによるエラー

WindowsとUnix系OS（LinuxやmacOS）で改行コードが異なるため、パッチ適用時にエラーが起きることもあります。

この場合は、git apply --ignore-whitespace のようにオプションを付ける、または事前に改行コードを統一しておくと対処しやすいです。

変更範囲が正しく取り込まれない

パッチファイルは基本的に「ファイルのどこをどのように変更するか」という情報を元に適用されます。

もしパッチ適用先の行数が大幅に変化していたり、ファイル構成が大きく書き換えられていたりすると、正しく適用されないケースがあります。

こうしたときは、前もってリポジトリ全体の状態を整理し、大きく構造が変わる前にパッチを適用するのがおすすめです。

git diff patch を使いこなすための注意点

patchファイルは、とても便利な差分管理手段ですが、いくつか留意すべき点があります。

コミットベースでのレビューと併用した方が良い

patchファイルはコミット履歴を含まないため、大掛かりな機能追加には向いていません。

多岐にわたる変更はブランチ運用で

たとえば機能の新規開発など大きな変更の場合は、ブランチを切ってプルリクエストでレビューを受ける方が見通しが良くなります。

小規模〜中規模のピンポイント修正に最適

バグ修正や簡単なリファクタリングなど、範囲が限定された修正を共有するのに向いています。

差分サイズが大きくなると見にくい

数百行を超えるような差分は、patchファイルでの管理やレビューが大変になることがあります。

パッチが大きくなりすぎると、レビューする側も混乱しがちです。
そのため差分を細かく分割するなど、読み手に配慮した管理を心がけましょう。

まとめ

git diff patch は、特定の差分だけを抽出して共有したり、別の環境で手軽に取り込むために役立つ方法です。

小さなバグ修正や一部の変更だけを他のブランチに先行して適用したいときなど、実務でも使いどころが多いといえます。

また、初心者の方がGitの仕組みを理解するうえでも、差分をテキストファイルとして確認しやすいのが利点です。

ただし、コミット履歴を丸ごと移したい場合や大規模な変更には向いていません。

そういったときは、ブランチ運用やプルリクエストを活用した方がスムーズに開発が進むでしょう。

皆さんも、いざというときに git diff patch を使いこなせるようになれば、差分管理の幅がぐんと広がるはずです。