1. 導入：なぜ cherry-pick が重要なのか
実務において「機能開発中だが、本番環境で発生した緊急のバグ修正（Hotfix）を、今すぐ現在の開発ブランチにも取り込みたい」という状況は頻繁に発生します。ブランチ全体をマージすると、まだ完成していない未リリースの機能まで混入してしまうリスクがあります。このような時、特定のコミットだけをピンポイントで抽出できる cherry-pick は、開発効率と安全性を両立させるための必須スキルです。
2. 基礎知識：cherry-pick とは
cherry-pick とは、指定したコミットハッシュ（一意のID）の内容を、現在のブランチに「新しいコミット」としてコピーする操作です。
元のコミットを移動させるのではなく、あくまで「変更内容の再現」を別のブランチで行うという点がポイントです。これにより、ブランチ構造を汚すことなく、必要な修正だけを摘み取ることができます。
3. 実装・解決策：基本的なワークフロー
まずは、取り込みたいコミットのハッシュを確認し、その後コマンドを実行します。
手順：
1. git log で取り込みたい修正のコミットハッシュを確認する。
2. 作業対象のブランチにチェックアウトする。
3. git cherry-pick <コミットハッシュ> を実行する。
もしコンフリクトが発生した場合は、修正後に git add で変更をステージングし、git cherry-pick –continue で処理を完了させます。
4. サンプルプログラム：実践的な操作例
以下の手順は、メインブランチで行った修正を開発中の機能ブランチに取り込む際の流れです。
1. 修正が含まれるブランチ（例: main）に切り替えてコミットIDを確認
git checkout main
git log –oneline
実行結果例:
a1b2c3d バグ修正: ログイン画面のバリデーション強化
2. 自分の作業ブランチへ移動
git checkout feature/new-login-ui
3. 特定のコミットだけを適用（cherry-pick実行）
コミットハッシュ ‘a1b2c3d’ を現在のブランチに取り込む
git cherry-pick a1b2c3d
4. もしコンフリクトが発生した場合の対処手順
エディタで対象ファイルを修正し、解決後に以下を実行
git add <修正したファイル名>
git cherry-pick –continue
5. 結果を確認
git log -n 1
新しいハッシュ値が割り当てられ、変更が適用されていることを確認できる
5. 応用・注意点：現場でのトラブル回避
cherry-pick を使う際に最も注意すべきは「依存関係」です。
特定のバグ修正が、別の機能実装やライブラリの更新に強く依存している場合、cherry-pick 先のブランチでコードが動作しなくなる可能性があります。
また、頻繁に cherry-pick を繰り返すと、元のブランチと取り込み先のブランチで「同じ変更内容を持つ異なるハッシュのコミット」が乱立し、後のマージ時にコンフリクトの原因となります。あくまで「緊急時の回避策」や「小規模な修正の移植」に留め、恒常的なコード共有にはプルリクエストやマージを活用するようにしましょう。
コメント