Git 指令查找器

Git 指令參考如何運作

工具功能說明

Git 指令參考提供可搜尋、可分類的常用 git 指令查詢，並依工作流程整理：復原變更、分支、暫存（stash）、rebase、標籤（tag）、遠端操作等。每個條目都會顯示指令語法、簡短說明其用途，以及實用的使用備註。搜尋會在你輸入時即時篩選條目，讓你不用翻 man pages 也能找到正確的咒語。

常見的開發者使用情境

開發者在知道想完成什麼（例如：復原上一個 commit 但保留變更為 staged）卻記不起精確旗標或指令時，會使用這份參考。它對較少使用的操作特別有幫助，例如互動式 rebase、挑揀（cherry-pick）範圍、從 reflog 復原已刪除的分支，或設定稀疏簽出（sparse checkout）。初階開發者也會把它當作學習輔助，用來發現自己不知道存在的指令。

資料格式、型別或變體

指令依邏輯分類整理：基本操作（add、commit、push、pull）、分支與合併、復原變更（reset、revert、checkout）、暫存（stashing）、rebase、標籤（tagging）、遠端管理、日誌與檢視，以及進階操作（bisect、worktree、submodule）。每個條目包含帶有佔位參數的指令範本、一行描述，以及相關旗標與其效果。

常見陷阱與邊界情況

Git 指令可能具有難以復原的破壞性效果——像是 'git reset --hard' 與 'git clean -fd' 會永久丟棄未保存在 reflog 中的工作。此參考展示常見用法模式，但 git 行為可能會因設定（merge.ff、pull.rebase）與 git 版本而異。有些指令在有無 '--' 分隔符時行為不同，特別是檔名與分支名稱衝突時。

何時使用此工具 vs 程式碼

在日常開發工作中，尤其是你不常執行的操作，使用這份參考來快速查指令。若是在正式環境中的複雜 git 工作流程（自動化發佈、合併佇列管理、monorepo 操作），請使用專用工具，例如 git aliases、Husky hooks 或 CI 腳本，把團隊特定的分支策略編碼進流程並降低人為錯誤的機率。