Git Rebase Onto

Git rebase --onto 指令可把某一段連續的 commits rebase 到新的 parent commit 上. 我通常會用這個方式捨棄當前 branch 和目標 branch 重複但不完全相同的 commits, 避免直接 rebase 時遇到 conflict.

Basic Git Rebase

• Rebase current HEAD to NEW_PARENT_COMMIT

  git rebase NEW_PARENT_COMMIT
  

• Rebase BRANCH on NEW_PARENT_COMMIT, then switch to new BRANCH

  git rebase NEW_PARENT_COMMIT BRANCH
  

Rebase a Series of Commits by –onto

• 所有要被 rebase 的 commits 都要是當下 HEAD reachable 的 commit, 也就是 HEAD 的 parent. 所以, 要先 checkout 要被 rebase commits 所在的 branch

  git checkout BRANCH_CONTAINS_COMMITS_TO_BE_REBASED
  

  或是 checkout 要被 rebase 的連續 commits 的最後一個 commit

  git checkout LAST_COMMIT_OF_COMMITS_TO_BE_REBASED
  

• 把 HEAD 上的某個 commit (REACHABLE_COMMIT) 的 parent comnmit (PARENT_OF_REACHABLE_COMMIT) 替換成另一個 commit (NEW_PARENT_COMMIT)

  git rebase --onto NEW_PARENT_COMMIT PARENT_OF_REACHABLE_COMMIT
  

• 把 HEAD 上的一段連續的 commits (FIRST_OF_REACHABLE_COMMITS 到 LAST_OF_REACHABLE_COMMITS) 取出, 並把這段連續 commits 的 parent 替換成另一個 commit (NEW_PARENT_COMMIT). 操作完後, HEAD 會指向新的 LAST_OF_REACHABLE_COMMITS.

  git rebase --onto NEW_PARENT_COMMIT PARENT_OF_FIRST_OF_REACHABLE_COMMITS LAST_OF_REACHABLE_COMMITS
  

• 若 LAST_OF_REACHABLE_COMMITS 改成 BRANCH_NAME, 則 LAST_OF_REACHABLE_COMMITS 即是 BRANCH_NAME 的 tips. 操作完後, HEAD 和 BRANCH_NAME 的 tips 都會指向 LAST_OF_REACHABLE_COMMITS

  git rebase --onto NEW_PARENT_COMMIT PARENT_OF_FIRST_OF_REACHABLE_COMMITS BRANCH_NAME
  

  效果等同如下指令.

  git checkout BRANCH_NAME
  git rebase --onto NEW_PARENT_COMMIT PARENT_OF_FIRST_OF_REACHABLE_COMMITS
  

Concliusion

Syntax

# Rebase a series of commits
git checkout BRANCH_NAME or REBASE_UNTIL_COMMI
git rebase --onto NEW_PARENT_COMMIT OLD_PARRENT_COMMIT <REBASE_UNTIL_COMMIT>

# Rebase a part of commits of a branch
git checkout BRANCH_NAME
git rebase --onto NEW_PARENT_COMMIT OLD_PARRENT_COMMIT

Reference

• Git rebase –onto an overview
• Git Doc – git-rebase