Git
PR

git cherry-pickの使い方:特定のコミットだけ取り込む方法と競合の対処

git cherry-pickの使い方:特定のコミットだけ取り込む方法と競合の対処
hr
記事内に商品プロモーションを含む場合があります

「開発中のブランチで直したバグ修正だけを先に main に入れたい」「間違えて別のブランチにコミットしたものを移したい」――こんなときに使うのが git cherry-pick(チェリーピック)です。ブランチ全体をマージせずに、選んだコミットだけを今のブランチに取り込めます。

この記事では、練習用のリポジトリで cherry-pick を実行しながら、基本・範囲指定・オプション・競合の対処・merge や rebase との使い分けを説明します。コマンドと実行結果は、Windows 11 の Git Bash(git --version の表示は「git version 2.49.0.windows.1」)で実際に実行して確かめたものです。コミット ID(3785614 のような英数字)は、実行するたびに変わります。

この記事で使うコマンド

やりたいことコマンド
コミットを 1 つ取り込むgit cherry-pick コミットID
A から B までを取り込む(A..B だと A は入らない)git cherry-pick A^..B
元のコミット ID をメッセージに残すgit cherry-pick -x コミットID
コミットせずに変更だけ取り込むgit cherry-pick -n コミットID
競合を直して続ける・この分を飛ばす・やめるgit cherry-pick –continue / –skip / –abort

ブランチの作り方と merge の基本は「Gitのブランチの使い方」で説明しています。コマンドを目的から探すなら「Gitコマンド検索」が便利です。

git cherry-pick とは?

公式ドキュメントの説明は「既存のコミットが持ち込んだ変更を適用する(Apply the changes introduced by some existing commits)」。かみくだくと、ほかのブランチにあるコミットの「変更の中身(差分)」だけを写し取って、今のブランチに新しいコミットとして作り直す操作です。

大事なのは、cherry-pick はコミットを「移動」するのではなく「コピー」するという点です。元のブランチのコミットはそのまま残り、取り込んだ側には別の ID の新しいコミットができます。

練習用のリポジトリを作る

Git Bash を開き、次のコマンドを上から順に実行してください(名前とメールアドレスの設定がまだなら「Git入門」を参照)。git init -b main は、最初のブランチ名を main にして始める指定です。

mkdir pick-test
cd pick-test
git init -b main

税率と送料を書いた calc.txt を作って、最初のコミットをします。

printf 'tax = 0.08\nshipping = 500\n' > calc.txt
git add calc.txt
git commit -m "最初のコミット"

feature/search ブランチを作り、4 つコミットします。2 つ目の「税率の計算ミスを修正」が、あとで main に取り込みたいバグ修正です。sed -i 's/0.08/0.10/' calc.txt は「calc.txt の中の 0.08 を 0.10 に置き換える」コマンドで、テキストエディターで書き換えてもかまいません。

git switch -c feature/search
echo "search" > search.txt
git add search.txt
git commit -m "検索画面を追加"
sed -i 's/0.08/0.10/' calc.txt
git commit -am "税率の計算ミスを修正"
echo "log" > log.txt
git add log.txt
git commit -m "ログ出力を追加"
echo "help" > help.txt
git add help.txt
git commit -m "ヘルプを追加"

main に戻り、別のコミットを 1 つ追加します。

git switch main
echo "MIT" > LICENSE
git add LICENSE
git commit -m "ライセンスを追加"

すべてのブランチの履歴を、枝分かれが分かる形で表示します。

git log --oneline --graph --all
* ab228e7 ライセンスを追加
| * 476fa02 ヘルプを追加
| * faaed1f ログ出力を追加
| * 3785614 税率の計算ミスを修正
| * 8fc9c85 検索画面を追加
|/
* afdabf9 最初のコミット

下から上へ時間が進みます。左の線が main、右の線が feature/search です(画面ではブランチ名も表示されます)。このあとのコマンドの ID は、自分の画面に表示された ID に置き換えて実行してください。

基本:コミットを 1 つだけ取り込む

今は main にいます。feature/search の「税率の計算ミスを修正」(3785614)だけを main に取り込みます。取り込む先のブランチに切り替えてから、取り込みたいコミットの ID を指定するのがポイントです。公式ドキュメントでは、コミットしていない変更がない状態で実行することが前提とされているので、変更があれば先にコミットするか git stash で退避しておきます。

git cherry-pick 3785614
[main 571affe] 税率の計算ミスを修正
 Date: Fri Oct 23 00:35:07 2026 +0900
 1 file changed, 1 insertion(+), 1 deletion(-)

もう一度 git log --oneline --graph --all で見ると、main の先頭に 571affe が増え、feature/search の 3785614 はそのまま残っています(図 1)。calc.txt は tax = 0.10 に変わり、search.txt・log.txt・help.txt はありません。選んだコミットの変更だけが入りました。

cherry-pick の前後のコミットの形。main で git cherry-pick 3785614 を実行すると、main の ab228e7 の次に、3785614 と同じ変更を写した別の ID のコミット 571affe ができる。feature/search は変わらない。
図 1:cherry-pick は選んだコミットの変更をコピーして、別の ID の新しいコミットを作る

コピーしたコミットの ID が変わる理由

コミット ID は、ファイルの状態・親のコミット・作成者・日時・メッセージなどから計算した値です。571affe の親は ab228e7(ライセンスを追加)で、元の 3785614 の親(8fc9c85)とは違います。

git log --format=fuller -1 で 2 つを比べると、作成者の日時(AuthorDate)は元のまま引き継がれ、コミットした日時(CommitDate)は cherry-pick を実行した時刻(元は 00:35:07、コピーは 00:35:12)になっていました。別の人(Alice)のコミットを取り込んだときも、Author は Alice のまま、Commit(コミットした人)は自分になりました。

複数のコミットを取り込む

ID をスペースで区切って並べると、まとめて取り込めます。ここからは git switch -c ブランチ名 main で main から試し用のブランチを作って試します。

git switch -c try-multi main
git cherry-pick 476fa02 faaed1f
[try-multi 6a4de96] ヘルプを追加
[try-multi 82edebe] ログ出力を追加

(この節と次の節の表示は、各コミットの 1 行目だけを載せています。)わざと新しい順(ヘルプ → ログ)に書いたところ、書いた順番のままコミットが作られました。公式ドキュメントにも、ID を並べた場合は履歴をたどらない(並べ直さない)とあります。前のコミットの変更を前提にしたコミットがあるときは、古い順に書きます。

範囲で指定する(A..B は A を含まない)

連続したコミットは A..B の形で範囲指定できます。ただし、A..B は「B からたどれるコミットのうち、A からたどれるものを除いたもの」という意味なので、A 自身は含まれません。「ログ出力を追加(faaed1f)からヘルプを追加(476fa02)まで」のつもりで試します。

git switch -c try-range main
git cherry-pick faaed1f..476fa02
[try-range 118fac5] ヘルプを追加

取り込まれたのは「ヘルプを追加」の 1 つだけで、範囲の始まりに書いた faaed1f(ログ出力を追加)は入りませんでした。始まりのコミットも含めたいときは、^(「その 1 つ前」という意味)を付けて A^..B と書きます。

git switch -c try-range2 main
git cherry-pick faaed1f^..476fa02
[try-range2 2c4fdb1] ログ出力を追加
[try-range2 46e9daf] ヘルプを追加

今度は 2 つとも、古い順に取り込まれました。範囲で指定した場合は、ID を並べたときと違って履歴の古い順になります。

-x で元のコミット ID を記録する

-x を付けると、コミットメッセージの最後に「どのコミットから取り込んだか」が 1 行追加されます。

git switch -c try-x main
git cherry-pick -x faaed1f

git log -1 で最新のコミットを見ると、メッセージの下に 1 行増えています。

commit 2d34e668a07cfd57ba50d2f83ca2147893d8ebf0
Author: hr <hr@example.com>
Date:   Fri Oct 23 00:35:08 2026 +0900

    ログ出力を追加

    (cherry picked from commit faaed1f111456f23180ea2d3935e05ceb9d21736)

公式ドキュメントでは、公開されたブランチどうし(保守用ブランチへのバックポートなど)では役に立ち、自分だけの作業ブランチからの取り込みでは付けないよう勧めています。また、この 1 行が付くのは競合しなかった場合だけです。

-n(–no-commit)でコミットせずに取り込む

-n(--no-commit)を付けると、変更をステージ(次のコミットに入れる場所)に入れるだけで、コミットは作りません。複数の変更を 1 つにまとめたいときや、手を加えてからコミットしたいときに使います。

git switch -c try-n main
git cherry-pick -n faaed1f 476fa02

何も表示されずに終わり、git status では「Changes to be committed:」の下に help.txt と log.txt が並びました。ここで自分でコミットします。

git commit -m "ログとヘルプを追加"

「[try-n beb2325] ログとヘルプを追加」「2 files changed」と表示され、2 つの変更が 1 つのコミットになりました。公式ドキュメントによると、このとき作成者(Author)は自分になります。

競合したとき(–continue・–abort・–skip)

取り込むコミットと今のブランチが同じ行を別々に書き換えていると、merge と同じように競合(コンフリクト)が起きます。わざと競合を起こしてみます。まず feature/search で送料を 600 円に変えます。

git switch feature/search
sed -i 's/500/600/' calc.txt
git commit -am "送料を600円に変更"

main では、同じ送料の行に「# 税込」というコメントを足します。

git switch main
sed -i 's/500/500  # 税込/' calc.txt
git commit -am "送料に税込のコメントを追加"

main に eba8620(送料を600円に変更)を取り込みます。

git cherry-pick eba8620
Auto-merging calc.txt
CONFLICT (content): Merge conflict in calc.txt
error: could not apply eba8620... 送料を600円に変更
hint: After resolving the conflicts, mark them with
hint: "git add/rm <pathspec>", then run
hint: "git cherry-pick --continue".

(hint: の行はこのあとも続き、–skip と –abort の案内が出ます。)「could not apply(適用できなかった)」と表示され、cherry-pick が途中で止まりました。このときの状態は git status で確かめられます。

git status
On branch main
You are currently cherry-picking commit eba8620.
  (fix conflicts and run "git cherry-pick --continue")
  (use "git cherry-pick --skip" to skip this patch)
  (use "git cherry-pick --abort" to cancel the cherry-pick operation)

Unmerged paths:
  (use "git add <file>..." to mark resolution)
	both modified:   calc.txt

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

2 行目は「cherry-pick の途中で止まっている」という意味で、その下に次にできる 3 つの操作が書かれています。calc.txt を開くと、ぶつかった行が印で囲まれています。

tax = 0.10
<<<<<<< HEAD
shipping = 500  # 税込
=======
shipping = 600
>>>>>>> eba8620 (送料を600円に変更)

<<<<<<< HEAD から ======= までが今のブランチ(main)の内容、======= から >>>>>>> までが取り込もうとしたコミットの内容です。merge のときと違い、下側の印にはブランチ名ではなくコミットの ID とメッセージが入ります。印の読み方と直し方は「Gitのコンフリクトの原因と解消方法」で詳しく説明しています。

やめる(–abort)・直して続ける(–continue)

git cherry-pick --abort

何も表示されずに終わり、git status は「nothing to commit, working tree clean」、calc.txt は shipping = 500 # 税込 に戻りました。cherry-pick を始める前の状態に戻すので、迷ったらまずこれで戻ってから考え直せます。

もう一度 git cherry-pick eba8620 を実行して競合させ、今度は直して進めます。calc.txt をテキストエディターで開き、印の 3 行を消して、両方の変更を生かした次の内容にして保存します。

tax = 0.10
shipping = 600  # 税込

直したファイルを git add して、「解消済み」の印を付けます。

git add calc.txt

ここで git status を実行すると、2 行目の下の案内が「(all conflicts fixed: run “git cherry-pick –continue”)」(すべての競合が直ったので続けてください)に変わります。続けます。

git cherry-pick --continue
[main e80b99b] 送料を600円に変更
 Date: Fri Oct 23 00:35:23 2026 +0900
 1 file changed, 1 insertion(+), 1 deletion(-)

元のメッセージのままコミットされました。環境によってはメッセージの編集画面(エディター)が開くので、そのまま保存して閉じます(Vim なら Esc キーのあと :wq と入力して Enter キー)。

このコミットだけ飛ばす(–skip)

複数のコミットを取り込んでいる途中で競合したとき、「このコミットは取り込まなくてよい」と分かったら --skip で飛ばして残りを続けられます。main の 1 つ前(送料を600円に変更を取り込む前)から試し用のブランチを作り、競合する eba8620 と「ヘルプを追加」(476fa02)を取り込みます。1 つ目で競合して止まったら、飛ばします。

git switch -c try-skip main~1
git cherry-pick eba8620 476fa02
git cherry-pick --skip
[try-skip d87bccb] ヘルプを追加
 Date: Fri Oct 23 00:35:09 2026 +0900
 1 file changed, 1 insertion(+)
 create mode 100644 help.txt

競合したコミットは取り込まれず、2 つ目の「ヘルプを追加」だけが取り込まれて終わりました。まとめると、–continue は直して取り込む、–skip はこの分だけ飛ばして残りは続ける、–abort は残りも含めてやめて始める前に戻る、です。

すでに取り込んだコミットをもう一度選んだとき

同じ変更がすでに入っているコミット(main に取り込み済みの 3785614)をもう一度 cherry-pick すると、変更が空になって「The previous cherry-pick is now empty」と表示されて止まります。空のコミットは普通いらないので、git cherry-pick --skip で飛ばします。範囲で取り込むときに --empty=drop を付けると、取り込み済みのものは「dropping … — patch contents already upstream」と表示されて自動で飛ばされました。

どのコミットが取り込み済みかは、git cherry -v main feature/search で先に調べられます。基本の cherry-pick の直後に実行すると、取り込み済みの 3785614 の行だけ先頭が -(同じ変更が main にある)、ほかの 3 つは +(まだない)でした。ID が違っても、変更の中身で比べてくれます。

cherry-pick とマージで同じ変更を 2 回取り込むときの注意

「バグ修正だけ先に cherry-pick し、残りは後でマージする」という流れはよくあります。基本の cherry-pick をした直後の main から作ったブランチ(try-merge)で feature/search をマージすると、競合せずに終わりましたが、git log --oneline --graph で見ると「税率の計算ミスを修正」が 2 回(main 側の 571affe と feature/search 側の 3785614)並んでいました。両方が同じ行を同じ内容に変えているので、競合しなかったのです。

問題になるのは、cherry-pick したあとで取り込み先がその行をさらに変えた場合です。main で税率を 0.12 に変えたブランチに feature/search をマージすると、calc.txt の税率の行で競合し、上側(HEAD)が tax = 0.12、下側(feature/search)が tax = 0.10 になりました。Git から見ると、feature/search 側の「0.08 → 0.10」はまだマージされていない変更なので、main の「0.12」とぶつかるのです。うっかり下側を選ぶと古い値に戻ってしまいます。後でマージする予定があるなら cherry-pick は最小限にし、-x を付けて「どれを先に取り込んだか」を分かるようにしておくと判断しやすくなります。

マージコミットを選ぶと -m が必要になる

マージコミットは親が 2 つあるので、どちらの親との差分を取り込むのかが決まらず、そのままではエラーになります。try-merge で feature/search をマージしてできたマージコミット(31510cc)を、別のブランチで取り込もうとしたときの表示です。

error: commit 31510cca6a99b103292549fee4543b78a816b87f is a merge but no -m option was given.
fatal: cherry-pick failed

-m で、基準にする親の番号(1 から数える)を指定します。普通は 1 番目の親が「マージした側(取り込み先)のブランチ」なので、-m 1 とすると「マージで入ってきた変更」をまとめて取り込めます。

git cherry-pick -m 1 31510cc

feature/search から入った 3 つのファイル(search.txt・log.txt・help.txt)が、親が 1 つの普通のコミットとして取り込まれました。ただし、メッセージは「Merge branch ‘feature/search’ into try-merge」のままで紛らわしいので、使うときは -e(メッセージを編集する)を付けて書き直すとよいでしょう。親の番号は git log -1 --format=%p 31510cc で確かめられ、今回は「571affe 476fa02」(左が 1 番目)でした。

merge・rebase との使い分け

コマンド取り込む単位元のコミット向いている場面
git mergeブランチ全体そのまま残る(ID も同じ)作業が終わったブランチを合流させる
git rebaseブランチ全体(自分のコミットを付け直す)新しい ID のコミットに置き換わる未 push の自分のブランチを最新の main に合わせる
git cherry-pick選んだコミットだけそのまま残り、別の ID のコピーができるバグ修正だけを先に入れる、間違えたブランチから写す

ブランチ全体なら merge か rebase、「一部だけ欲しい」ときが cherry-pick です。rebase の詳しい使い方は「git rebaseの使い方とmergeとの違い」で説明しています。

よくある質問

終わった cherry-pick を取り消したいときは?

まだ push していなければ、git reset --hard HEAD~1 で直前のコミットごと消せます(「HEAD is now at …」と表示され、1 つ前に戻りました)。注意:git reset --hard はコミットしていない変更もすべて消すので、先に git status で確かめてください。push したあとなら、履歴を書き換えずに打ち消すコミットを作る git revert HEAD を使います。取り消し方の選び方は「Gitで取り消す方法まとめ」を参照してください。

まとめ

  • cherry-pick は、選んだコミットの変更を今のブランチにコピーする。取り込む先に切り替えてから実行し、できたコミットは別の ID になる
  • ID を並べると書いた順、A..B は A を含まない範囲、A^..B は A を含む範囲。-x は元の ID を記録、-n はコミットせずに取り込む
  • 競合したら「直す → git add → –continue」、飛ばすなら –skip、やめるなら –abort。後でマージする予定のブランチからの取り込みは最小限に

関連する記事・ツール

ABOUT ME
hr
hr
エンジニアとして働いている hr です。仕事や資格勉強で「こんなツールがあれば」と感じたものを、無料Webツールと解説記事にして発信しています。
記事URLをコピーしました