常見的 Git 指令是開發者每天執行的一小組反覆出現的指令集,用於初始化存放庫、檢查其狀態、暫存檔案、記錄提交、切換分支,以及與遠端交換工作。一份精簡的搜尋與複製參考資料把這組反覆出現的指令集中在一處,讓你把較少的時間花在猜測語法上,把更多時間用於閱讀你的存放庫實際上在做什麼。最常用的十二個範本涵蓋了完整的日常工作循環:啟動或複製存放庫、使用簡潔旗標檢查狀態、檢視未暫存的差異、閱讀帶裝飾的紀錄日誌、新增特定路徑、帶訊息提交已暫存的內容、命名當前分支、切換或建立分支、擷取時進行修剪,以及推送時附帶上游追蹤參考。每個範本都以可複製的字串形式呈現,並以尖括號預留位置標示如 <url>、<path>、<message> 和 <branch> 等數值,請在執行前替換這些內容。這個列表刻意精簡——它偏好明確的現代指令以及「先檢查再行動」的習慣,這些在所有 Git 版本中運作方式相同,而非包羅萬象的別名目錄、改寫歷史的祕訣,或需要更強上下文與復原規劃的危險操作。
完整列表位於 Git 速查表,其中按類別、指令或工作流程用途搜尋十二個經來源查證的 Git 指令。開啟它,輸入你即將執行的工作流程,檢查預留位置、分支和遠端上下文後,只複製你需要的那一行。

十二個核心 Git 指令涵蓋了什麼
這份參考資料圍繞著開發者實際執行的反覆循環而建構:啟動或複製存放庫、查看變更內容、暫存正確的路徑、記錄提交、分支出來或合併回去,以及與遠端分享工作。下表中每個項目都對應到其中一個步驟,並使用官方 Git 參考手冊記載為推薦形式的明確現代指令。
| 工作流程步驟 | 範本 | 功能說明 |
|---|---|---|
| 初始化 | git init | 在當前目錄中建立一個空的存放庫。 |
| 複製 | git clone <url> | 將遠端存放庫複製到新的本地目錄。 |
| 簡潔狀態 | git status --short | 以兩欄摘要顯示已追蹤、已暫存、已修改、已刪除及未追蹤的路徑。 |
| 未暫存差異 | git diff | 顯示工作目錄中尚未進入索引的變更。 |
| 帶裝飾的紀錄 | git log --oneline --decorate --graph -n 10 | 列印十筆帶有分支與標籤標記的提交,提供快速上下文。 |
| 暫存路徑 | git add <path> | 將特定檔案或目錄移入索引,範圍比暫存整個工作樹更精準。 |
| 提交已暫存內容 | git commit -m <message> | 以描述意圖的訊息記錄已暫存的快照。 |
| 當前分支 | git branch --show-current | 列印此工作副本中已簽出的分支名稱。 |
| 切換分支 | git switch <branch> | 移至現有的本地分支。 |
| 建立並切換 | git switch -c <branch> | 一步驟建立新的本地分支並簽出。 |
| 擷取時修剪 | git fetch --prune | 下載遠端參考並移除過時的遠端追蹤名稱,但不進行合併。 |
| 推送並設定上游 | git push -u origin <branch> | 發布當前分支並記錄上游追蹤參考。 |
其中四個項目——git status --short、git diff、簡潔帶裝飾的紀錄,以及 git branch --show-current——是檢查指令,不會變更存放庫的任何內容。其中兩個——git init 與 git clone——用於啟動工作副本。另外兩個——git add 與 git commit——用於在本機記錄工作。剩下的四個——git switch、git switch -c、git fetch --prune 與 git push -u——會變更分支或遠端狀態。涉及網路的操作包含 clone、fetch 與 push,每個都以明確、可復原的形式書寫。強制推送、硬重設、清理、變基與改寫歷史等操作刻意排除;Atlassian Git 教學以富含上下文的形式涵蓋了這些祕訣,不適合放在快速複製的清單中。
如何搜尋並複製安全的範本
這份速查表是本機、唯讀的參考資料。它不會執行 Git、開啟存放庫、上傳資料,也不會儲存你複製的指令,且無需登入。請將它作為四步驟例行工作來使用:
- 依指令、類別或任務搜尋。輸入諸如 commit、branch、remote 或 staged 等詞,從十二個項目中篩選出符合你即將執行的工作流程的那一個。
- 閱讀範本旁的描述,確認指令確實符合當下情境——例如,未暫存的工作使用 git diff,已在索引中的內容則使用 git diff --cached。
- 將每個尖括號預留位置(如 <url>、<path>、<message> 或 <branch>)替換為適合該存放庫與 shell 的值。請勿將尖括號原樣輸入。任何包含空格或 shell 敏感字元的路徑或訊息,請加上引號。
- 僅在確認工作目錄、當前分支、已設定的遠端、已暫存差異以及任何存放庫指示後,才複製指令;執行後請再次檢查產生的狀態、差異、提交或遠端狀態。
複製的指令並不會因為語法有效就自動安全。存放庫、shell、權限、勾選腳本與協作政策仍然由你負責。如果範本看起來正確,但描述警告它可能改寫歷史,請放棄這次變更,改閱讀完整手冊——速查表已經基於這個理由把那些祕訣過濾掉了。
預留位置與 Shell 安全規則
範本中的每個尖括號標記都是預留位置,而非字面字元。請將 <url> 替換為遠端 URL,<path> 替換為存放庫內的相對或絕對路徑,<message> 替換為說明意圖的簡短句子,<branch> 替換為本地或遠端追蹤分支名稱。任何包含空格、shell 中繼字元或引號的值,請依 shell 規則以單引號或雙引號包裹。絕對不要將機密資訊貼入提交訊息、遠端 URL 或分支名稱中。
在工作流程中有些容易忽略的陷阱。git add <path> 刻意比暫存整個工作樹更精準:請確實檢視進入索引的內容,特別是在含有產生檔案、憑證、資料庫或無關使用者工作的共用簽出中。提交記錄的是已暫存的內容,而非每個可見的變更,因此請撰寫說明意圖的訊息,並把邏輯上獨立的工作分為不同的提交。勾選腳本可能修改或拒絕提交,因此提交成功後請檢查最終的提交,而非假設已暫存的快照保持不變。輸出描述的是存放庫在某個時間點的狀態;其他程序、編輯器、勾選腳本或協作者稍後可能變更檔案或參考,這就是為什麼例行工作在每次提交或推送前,要以重新檢查作為結束。
「先檢查再變更」的習慣
檢查指令應在變更之前執行。在執行任何會將檔案移入索引、記錄提交、切換分支、擷取新參考或向上游推送分支的操作之前,請先閱讀簡潔狀態、掃描未暫存差異,並瀏覽帶裝飾的紀錄日誌。簡潔帶裝飾的紀錄範例顯示十筆帶有分支與標籤標記的提交,但診斷時可能需要更深入的歷史或限制路徑的紀錄——當預設檢視隱藏了你需要的上下文時,請傳入路徑或更大的 -n 值。
分支與遠端操作即使看似在本機,也會影響協作。git switch -c <branch> 會建立本地分支;git push -u origin <branch> 會將其發布並記錄上游追蹤參考,使未來的 git pull 與 git push 呼叫知道該往哪裡進行。git fetch --prune 會下載參考並移除過時的遠端追蹤名稱,但不會合併到當前分支;不過修剪可能讓已刪除的遠端分支從本地追蹤檢視中消失,因此在共用簽出上執行前,請先確認遠端 URL 與存取政策。完整的「先檢查再行動」例行工作記載於 先檢查再行動工作流程指南,它將同樣的十二個指令擴展為每日檢查清單。
參考資料刻意省略的內容
速查表的價值來自它省略的內容與它收錄的內容一樣多。強制推送、硬重設、清理、變基與改寫歷史的祕訣被省略,是因為它們可能丟棄或改寫工作,並且需要針對存放庫的復原規劃——一份不含上下文的快速複製清單不適合放這些內容。如果團隊工作流程需要簽署提交、受保護分支、拉取請求或不同的遠端名稱,這些範本仍可作為起點,但請在進行任何不熟悉的變更前,依專案文件與可復原的備份或分支來確認慣例。Git 版本與組織政策可能不同,因此當範本對你而言是新的,請查閱 git help <command> 與完整手冊。
當自動化程式呼叫 Git 時,請固定工作目錄、處理結束代碼,並擷取足夠且不敏感的輸出以診斷部分失敗,同時避免洩露憑證。速查表本身不會執行 Git、開啟存放庫、上傳資料或儲存指令;它在本機且唯讀,直到你選擇複製文字為止。十二個項目已針對唯一識別碼與指令範本,對照上游文件和獨立的教學來源進行查驗,但沒有任何參考資料能取代你在每次提交與推送前,閱讀存放庫實際輸出的實作習慣。