Git

PATerminal 把 Git 放在你需要的地方:每個窗格都會顯示所在存放庫的狀態,Git 視窗則提供處理提交、歷史與分支的完整用戶端。所有操作都透過你電腦上的 git 執行。

以 PATerminal v1.8.3 為準撰寫

窗格列中的 Git

當窗格位於存放庫中時,它的上方列會顯示目前的分支、領先(↑)與落後(↓)的提交數,以及已變更的檔案數。旁邊還有:

分支名稱
開啟分支清單:先列出本機分支,再列出只存在於遠端的分支。按一下分支(或按 Enter)即可切換。輸入不存在的名稱並按 Enter,即可建立該分支並切換過去。已在其他 worktree 中檢出的分支會加上標記,無法選取。
Diff
開啟此窗格資料夾中尚未提交的變更,不需要開啟 Git 視窗。
Worktree
為這個存放庫建立 worktree。請參閱 Worktree。
Commit
開啟 Git 視窗的檔案狀態,並將焦點放在訊息輸入框。
擷取 / 拉取 / 推送
有可以拉取的內容時,「拉取」會醒目顯示。如果沒有設定上游分支,會從遠端的預設分支(例如 origin/main)拉取;工具提示會註明來源。有尚未推送的提交時,會出現「推送」。

Git 視窗

按一下工具列中的 Git 或按 Cmd/Ctrl+E,即可為目前聚焦終端機所在的存放庫開啟 Git 視窗。工具列上的徽章會顯示已變更的檔案數。按 Esc、× 按鈕或再按一次 Cmd/Ctrl+E 即可關閉。拖曳邊緣可調整大小;在控點上按兩下可恢復預設大小。

左側可以在 檔案狀態、歷史、搜尋、worktree、Issue 與 PR 之間切換,並列出 分支(依 / 分組成資料夾)、遠端 與 標籤。按一下參照即可在歷史中顯示它的提交;在分支上按兩下即可檢出。

檢視並提交變更

  1. 開啟 Git 視窗。它會先顯示 檔案狀態,列出每個尚未提交的檔案及其狀態與行數變化。
  2. 按一下檔案即可查看附行號的 diff。取消勾選不想納入這次提交的檔案。
  3. 在 提交訊息 中寫下說明。勾選 提交後 Push 可立即推送。
  4. 按 Commit 或 Cmd/Ctrl+Enter。

所有變更 會在較大的檢視器中開啟整個工作目錄的 diff。過長的行會自動換行,你也可以拖曳檔案清單的邊緣把它拉寬。

瀏覽歷史

歷史 會繪製涵蓋所有本機與遠端分支及標籤的提交圖。選取一個提交,即可在下方查看它的檔案與修補內容。搜尋 可依提交訊息、作者或雜湊值篩選。

在提交上按右鍵 → 回復到這個提交…,會將分支重設到該提交。之後的提交會離開目前的歷史,已追蹤檔案中尚未提交的變更也會被捨棄(未追蹤的檔案會保留),因此會先請你確認。

拉取、推送、擷取與 stash

Pull
選擇要拉取到目前分支的遠端分支,不需要切換分支。
Push
推送目前分支,第一次推送時會設定它的上游分支。
Fetch
從所有遠端擷取更新。
Stash
暫存變更,包括未追蹤的檔案(git stash push -u)。

Git 無法執行時

如果你的電腦讓 git 無法運作,PATerminal 會說明原因並提供一行修正指令,你可以用 輸入到終端機 插入(由你按 Enter),或按 複製。它能辨識以下情況:尚未同意 Xcode 授權、缺少 Command Line Tools、未安裝 Git、資料夾由其他使用者擁有(「dubious ownership」),以及 Windows 的長路徑限制。

還是卡住了嗎?

請先查看常見問題,或寄信告訴我們你的作業系統、PATerminal 版本,以及你已經嘗試過的方法。每封來信我們都會回覆。