獨立腳本跑在子處理序裡,它的 cd 只會影響自己,結束後你的終端機還在原地。只有載入目前 shell 的函式能改變工作目錄,所以 gwt 是一個被 source 的函式,不是執行檔。
git worktree 的
互動式切換指令
在終端機列出所有 worktree,用方向鍵選好,按 Enter 就切過去。
安裝
git clone https://github.com/doggy8088/git-worktree-tui.git
cd git-worktree-tui && bash install.sh
> git worktree add ../shop-feature-tests -b feature/tests
Preparing worktree (new branch 'feature/tests')
> gwt
請選擇 Worktree (↑/↓ 移動, Enter 確認, 按 1-5 直接跳轉, q/Esc 取消):
> cd ~/projects/shop-feature-search-api
~/projects/shop-feature-search-api
>
這是執行時的畫面:欄寬、光棒、分支顏色都和終端機裡一樣。
以前要在一堆路徑裡找一個目錄 先列出、再複製、貼到 cd 後面 gwt 把這四步收成一個 > 和一次 Enter。
先執行 gwt,看清單
在儲存庫或任何一個 worktree 裡執行,它會列出這個儲存庫的所有工作目錄。
> gwt
請選擇 Worktree (↑/↓ 移動, Enter 確認, 按 1-5 直接跳轉, q/Esc 取消):
用 ↑ ↓ 或 j k 直接操作這個選單,按 Enter 看看會發生什麼事。
40 個 worktree 時,選單只顯示終端機放得下的那一段
> gwt --list | wc -l
40
請選擇 Worktree (↑/↓ 移動, Enter 確認, 按 1-40 直接跳轉, q/Esc 取消):
顯示 8-16,共 40 筆
六個按鍵
就夠了
- ↑ ↓
- 上下移動,到頭尾會循環 不動
- j k
- 跟 Vim 一樣的上下移動 不動
- 1 – 9
- 直接跳到該編號並切換 切換
- Enter
- 切換到反白的 worktree 切換
- q Esc
- 取消,維持原本的目錄 不動
- Ctrl C
- 中斷,游標一定還回來 不動
清單比畫面高時只顯示一段視窗,選取項目會帶著視窗捲動,下方標示目前範圍。
它讀的是這份輸出
worktree /Users/will/projects/shop
HEAD 89ae97a1b2c3d4e5f6
branch refs/heads/main
worktree /Users/will/projects/shop-feature
HEAD 89ae97a1b2c3d4e5f6
branch refs/heads/feature/search-api
worktree /Users/will/projects/shop-hotfix
HEAD 89ae97a1b2c3d4e5f6
detached
用 --porcelain 而不是給人看的對齊格式,路徑含空白也不會被切開。
小,而且驗過
每一個行為都有測試把關,包含在真的終端機裡送按鍵的互動測試。
25
個測試,其中 15 個是開著 PTY 送按鍵的互動測試
2
個平台跑 CI:Ubuntu 與 macOS
0
個執行期依賴,只需要 zsh 與 git
常見問題
會顯示一個符合終端機高度的視窗,選取項目帶著它捲動,下方標示目前範圍。原本清單超過畫面高度時,游標上移會被終端機夾住,整段區塊會飄走,這個問題在 0.1.0 之後修掉了。
顯示 8-16,共 40 筆
目前只支援 zsh,因為用到 read -k 與從 1 起算的陣列索引。改寫成 bash 要換成 read -n 1 並重測游標行為,這件事在待辦清單上。
不會。gwt 只讀清單、只做 cd,不執行 git worktree prune,也不刪任何目錄。要清掉失效的 worktree 請自己執行 git 的指令。
設定都是環境變數:GWT_LANG 換中英文、GWT_NO_COLOR 關顏色、GWT_WIDTH 與 GWT_HEIGHT 指定選單尺寸、GWT_CLEAR_ON_EXIT 決定選完要不要擦掉選單、GWT_DIGIT_TIMEOUT 調整多位數編號的等待時間。
在專案目錄執行 git pull 就是新版;.zshrc 只有一行 source,不必再改。想固定版本就執行 make install,它會把函式庫複製到 ~/.zsh/gwt.zsh。
先裝起來
再回來看
兩行指令,之後在任何儲存庫裡打 gwt。
git clone https://github.com/doggy8088/git-worktree-tui.git && cd git-worktree-tui && bash install.sh