HOWTO · Git

Git で特定のコミットにリベースする

git rebase --onto を使って、ブランチを特定のコミットにリベースし、移動するコミットを選択します。

このページの内容

Git のブランチを特定のコミットにリベースするには、git rebase --onto <newbase> <upstream> [<branch>] を使います。Git は、ブランチから到達でき、upstream からは到達できないコミットを newbase の上に移します。以下の例では new-feature と main を使います。省略形のコミット ID は、リポジトリにあるものに置き換えてください。これらは Git 標準の操作を示す例であり、実行はしていません。

Git で特定のコミットにリベースする

まず git status --short --branch と git log --oneline --graph --decorate --all でブランチ名、作業ツリー、コミットグラフを確認します。移動先のコミット、移動するコミットを区切る upstream の境界、リベースするブランチを特定してください。リベースするとコミット履歴が書き換わるため、対象のブランチで作業していることを確かめ、ほかの人も使うブランチを書き換える前に関係者と調整しましょう。

--onto では、最初に新しいベースを指定し、次に upstream の境界を指定します。省略可能な第 3 引数はリベースするブランチを指定するもので、新しい親コミットを指定するものではありません。この引数を省略すると、Git は現在チェックアウトしているブランチ、つまり HEAD が指すブランチをリベースします。

たとえば、846e2fa が main にある移動先のコミットで、bd9172c が new-feature 上のコミット群より前にある upstream の境界だとします。対象のコミットを選んだコミットの上に移すには、git rebase --onto 846e2fa bd9172c new-feature を実行します。Git は new-feature からは到達でき、bd9172c からは到達できないコミットを選び、それらを 846e2fa の上に再適用します。

リベースする範囲の先頭のコミットを除外する

ブランチ上の最初のコミットを含めないようにするには、そのコミットを upstream の境界に指定します。除外したい最初のコミットが e2ff2bc なら、git rebase --onto 846e2fa e2ff2bc new-feature を実行します。Git は new-feature からは到達でき、e2ff2bc からは到達できないコミットをリベースします。このため、選択範囲から e2ff2bc とその祖先が除外されます。先にコミットグラフを確認し、e2ff2bc が意図した境界であることと、後続のコミットに残したい変更が含まれていることを確かめてください。

リベースする範囲の最後のコミットを除外する

ブランチを指定しても、その先端のコミットが自動的に除外されるわけではありません。先端のコミット d7dbeb を除外しながら範囲を 846e2fa の上に移すには、対話型リベースを使います。git rebase -i --onto 846e2fa bd9172c new-feature を実行してください。編集画面の todo リストで d7dbeb のコマンドを pick から drop に変更するか、その行を削除してから、保存してエディターを閉じます。ほかのコミットは pick のままにします。これにより、bd9172c より後の同じ範囲を選び、Git がリストを再適用する際に不要な先端のコミットを明示的に除外できます。

新しい履歴を確認し、競合に対処する

リベース後、git log --oneline --graph --decorate --all を確認し、new-feature が 846e2fa 上の想定した履歴を指し、意図したコミットだけが含まれていることを確かめます。必要に応じて git diff main...new-feature で main との差分を確認してください。

Git が競合で停止した場合は、該当ファイルを調べて競合を解消し、解決したファイルを git add <file> でステージします。git rebase --continue で続行できます。進行中のリベースを取り消し、ブランチを開始時の状態に戻すには git rebase --abort を使います。共有する前に、もう一度履歴を確認しましょう。リベースするとコミット ID が変わるため、共有ブランチに書き換え後のコミットをプッシュする際は関係者との調整が必要です。また、慎重に確認したうえで強制プッシュが必要になる場合があります。