拆開 fzf 腳本：每支背後真正在跑的 Git 指令

Thu, 29 Oct 2026 10:55:56 +0800

起因

上一篇講的是這些腳本怎麼設計。這篇反過來：把 fzf 那層剝掉，看每支腳本實際在跑哪幾條 git 指令。

理由很實際。腳本不在手邊時（別人的機器、CI、container），你還是得自己打這些指令。而且拆的過程中，我挖出了兩個藏了很久的 bug。

共用底層

每支腳本開頭都是同一組檢查：

git rev-parse --is-inside-work-tree # 不在 repo 裡就結束
git rev-parse --show-toplevel # cd 到 repo 根目錄

需要 cd 到根目錄，是因為 git status --short 和 git diff --name-status 印出的路徑都是相對於 repo 根目錄。在子目錄裡直接拿去當 pathspec 用，就會對不上。

列分支用的是 git branch --format，語法和 git for-each-ref 一模一樣，連條件式都能寫：

git branch -l --format='%(refname:short) [%(objectname:short)] %(if)%(upstream)%(then)-> %(upstream:short)%(else)<no upstream>%(end)'

gitbr：查分支指向哪裡

gitbr 的用途是：不 checkout 也能知道一條分支指向哪個 commit、有沒有追蹤 upstream，並把 short SHA 複製到剪貼簿。核心只有三條：

git branch --show-current # 目前分支名稱
git rev-parse <ref> # ref → SHA
git rev-parse --abbrev-ref <branch>@{upstream} # 追蹤的遠端分支

<branch>@{upstream}（縮寫 @{u}）指的是 branch.<name>.merge 設定的那條 remote-tracking branch。如果沒有設定，指令會失敗，所以腳本後面接了 || true。

把 Git 包成互動式 CLI：10 支 fzf 腳本的設計筆記

Mon, 31 Aug 2026 11:42:11 +0800

起因

上一篇整理的那幾條指令，參數本身都不難記。麻煩的是那種要先查才能打的情境。

想 checkout 一個還沒 checkout 過的遠端分支，得先 git branch -r，用眼睛掃一遍，再手動打分支名。想把某段 commit 搬到別條分支，git rebase --onto <new-base> <old-base> <until> 三個參數各是什麼，我每次都要想。想拿某個 commit 的 SHA，git log --oneline 之後反白複製。

這些操作花時間的部分是選，不是執行。fzf 剛好就是拿來解決選的問題。

於是有了 10 支腳本，命名一律是 git 加兩個字母，取自指令本身的大寫字母。

共同骨架

每支腳本第一行做的事都一樣：source 同一個 helpers/git_utils.sh。裡面沒什麼特別的，就是色彩輸出跟前置檢查：

function hl() { printf '\033[1;33m%s\033[0m' "$1"; }
function info() { printf '[\033[1;36mINFO\033[0m] %s\n' "$1"; }
function check_git() {
 git rev-parse --is-inside-work-tree > /dev/null 2>&1 || { err "Not a git repository."; exit 1; }
}

比較值得提的是 get_local_branches。用 --format 把四個欄位塞在同一行：

local format="%(if)%(upstream)%(then)%(refname:short) [%(objectname:short)] -> %(upstream:short)%(else)%(refname:short) [%(objectname:short)] <no upstream>%(end) %(contents:subject)"
git branch -l --format="${format}"

這樣在 fzf 清單裡一眼看得到分支名、short SHA、追蹤的 upstream、最後一筆 commit 標題，而 awk '{print $1}' 還是能乾淨取回分支名。

Fzf on 終於明白 | tsungyi knows.

拆開 fzf 腳本：每支背後真正在跑的 Git 指令

起因

共用底層

gitbr：查分支指向哪裡

把 Git 包成互動式 CLI：10 支 fzf 腳本的設計筆記

起因

共同骨架