Skip to main content

Git Absorb 繁體中文唯一教學

Git 教學現在有獨立的網站了！請移駕 Git 零到一百。

你是否常常遇到這種情況？完成多個提交後，在推送前的最終檢查卻發現每個提交都有 typo 要修正，這時候有兩種解決方法，一種是 rebase -i 進去 edit，另一種是再額外提交新的版本後使用 rebase -i，然後修改順序並且改為 fix，兩者都要手動進行重複操作非常麻煩，這時候就需要我們的 git absorb 出動了。

除了上述情境，在審核 PR 時，如果有多個提交也要這樣修改，為了保持提交的原子性 atomic，我們也不會想新增一個 fix: xxxx 修改三個提交，而是希望對三個提交各自進行修正。

原理​

如果已經很熟悉 git rebase --autosquash 請跳過此段。

git rebase --autosquash 用途是把帶有特定 commit message 前綴的提交進行自動處理，例如 commit message 前面帶有

  1. fixup!
  2. squash!

這些提交就會自動被 fixup/squash 到對應的提交裡面，這樣就達到我們前言裡面說的各自修正了。以 Git 內建的指令步驟要這樣操作：

git add <file>

git commit --fixup=<commit>

git rebase -i <要被fixup的那個提交>^ --autosquash

# 操作 Vim 編輯器

這有兩個大問題，第一，要找到 --fixup=<commit> 這無疑是 Git 裡面最討厭的步驟，要嘛一個一個數然後 ~N，要嘛開新的 git log 然後手動輸入 hash；第二，步驟太多，工程師就是很懶，所以這時候 git absorb 指令就可以解決這個問題。

git absorb​

git absorb 會自動檢查應該被合併到哪個提交中，所以就不再需要前面繁瑣的步驟了，不用再去翻 log 翻到眼睛都花掉，指令會自動判斷應該被合併到哪個提交中。

git absorb 指令預設是保守的，避免錯誤的合併讓你要拆分反而造成更多麻煩，所以有時候會提示 warning 說找不到，這時可以使用手動使用前面的方式完成。

安裝​

# Windows
winget install tummychow.git-absorb

# MacOS
brew install git-absorb

# Ubuntu
apt install git-absorb

自動 rebase​

因為這個指令的目的就是要簡化操作所以使用非常簡單：

git add $FILES_YOU_FIXED
git absorb --and-rebase

如果 rebase 過程中想要退出，請使用 :cq 告訴 Git 這是錯誤執行，Git 會取消這次 rebase。

如果作者不同請加上 --force-author

git absorb --and-rebase --force-author

如果搜尋範圍不夠大可以指定 --base

git absorb --and-rebase --force-author --base <base-commit>

rebase 前檢查​

使用 --and-rebase 會自動完成 rebase，如果你覺得這樣有點不安心，想要事前確認他會被 absorb 到哪個 commit 中，可以使用此指令：

git add $FILES_YOU_FIXED
git absorb # 不加上 and-rebase
git log # 檢查
git rebase -i --autosquash HEAD~<2N+1>

這裡的 N 代表 fixup 的數量，rebase 範圍要兩倍才會找到要被合併的目標提交。如果歷史記錄更遠那就需要手動指定 commit。

標籤：
更新日期：