Tig
Tig 是一套基於 ncurses 的 Git 文字模式介面。它主要作為 Git 儲存庫瀏覽器使用。
使用時機
- 終端機式 Git 歷史導航:在無頭伺服器環境中快速瀏覽提交圖譜、分支與標籤。
- 互動式暫存與區塊提交:在不離開終端機的情況下審閱差異、暫存區塊以及還原未暫存的行。
- Blame 與程式碼註解:逐行檢查提交作者、時間戳與提交記錄(
tig blame)。 - 低開銷 Git 審計:透過 SSH 連線審計大型企業 Git 儲存庫,無 GUI 延遲。
快速入門
1. 常用指令
# 開啟主要分支提交圖譜
tig
# 檢視特定檔案的歷史紀錄
tig path/to/file.ts
# 檢視未提交變更的差異(Status 檢視)
tig status
# 互動式 blame 檢視
tig blame path/to/file.ts
2. 基本導航按鍵
m:切換至 Main(提交圖譜)檢視s:切換至 Status(暫存)檢視d:檢視選取提交的差異b:Blame 檢視u:暫存 / 取消暫存選取的檔案或差異區塊q:關閉當前檢視 / 離開
核心概念
生產環境 Tig 設定檔(~/.tigrc)
自訂顏色、按鍵綁定與檢視版面配置:
# ~/.tigrc
# 一般設定
set line-graphics = utf-8
set tab-size = 2
set main-view = id date:relative author:email-user commit-title:graph=yes,refs=yes
set diff-view = line-number:yes,interval=5
set status-view = line-number:yes
# 按鍵綁定:Vim 導航
bind generic j move-down
bind generic k move-up
bind generic g move-first-line
bind generic G move-last-line
bind generic <Ctrl-f> page-down
bind generic <Ctrl-b> page-up
# 快速操作
bind main <Enter> view-diff
bind status u stage-update
bind status s stage-update
bind status c !git commit -v
互動式暫存檢視與區塊暫存
在 Status 檢視中導航以審閱並暫存變更:
# 直接以狀態模式開啟 Tig
tig status
# Status 檢視中的按鍵操作:
# - 按 'u' 暫存/取消暫存檔案或區塊
# - 按 'Enter' 開啟選取檔案的差異檢視
# - 按 '1' 暫存單行
# - 按 'c' 開啟編輯器並建立提交
使用 tig blame 調查回歸問題
透過儲存庫歷史追溯程式碼行修改:
# 為特定檔案啟動互動式 blame 檢視器
tig blame src/auth/jwt_validator.go
# Blame 檢視中的導航:
# - 在任一行按下 'Enter' 以檢視引入該行的完整提交差異
# - 按 ',' 以 blame 該變更之前的父提交
# - 按 'q' 返回前一個檢視
常見工作模式
#自訂 Tig 按鍵綁定(~/.tigrc)
問題:需要快速的終端機暫存、rebase 與分支切換。
解決方案:在 ~/.tigrc 中定義自訂快速鍵。
# ~/.tigrc
# 將 'F' 綁定為從遠端提取
bind generic F !git fetch origin
# 在 Status 檢視中將 'C' 綁定為快速提交
bind status C !git commit -v
# 將 'P' 綁定為推送當前分支
bind generic P !git push origin HEAD
最佳實踐(2026)
- 務必在
~/.tigrc中設定main-view為commit-title:graph=yes,refs=yes,以顯示清晰的階層式分支結構。 - 務必使用
tig blame快速找出哪個 PR 或提交引入了有問題的程式碼行。 - 務必利用
tig status審閱並暫存個別行區塊(1),以達成精細、乾淨的 Git 提交。 - 務必在
.tigrc中將預設導航按鍵重新映射為j/k(若習慣 Vim 按鍵綁定)。 - 切勿在 Tig 中留下未解決的合併衝突;應使用 Tig 檢視衝突狀態,並在編輯器中解決。
- 切勿在數 GB 的大型儲存庫中執行完整歷史的 Tig 檢視,而不指定分支或路徑限制。
- 切勿忘記按
q回上一層檢視,而非直接結束工作階段。
疑難排解
| 錯誤 / 症狀 | 原因 | 解決方案 |
|---|---|---|
| 終端機中顏色難以閱讀 | 終端機主題對比與預設 Tig 調色盤衝突 | 在 ~/.tigrc 中設定自訂顏色(例如 color diff-stat green default)。 |
| Tig 開啟在錯誤的 Git 儲存庫根目錄 | 當前工作目錄位於子模組內或儲存庫外部 | 在執行 tig 前,先用 git rev-parse --show-toplevel 檢查。 |
blame 檢視出現 cannot open file: ... | 檔案已重新命名或在工作目錄中被刪除 | 明確傳入提交參考:tig blame HEAD~2 -- path/to/file。 |