設定
首次使用時,請閱讀 setup.md。預設為最佳實務模式 (無需設定)。
使用時機
使用者需要 Git 專業知識 — 從基本操作到複雜的工作流程。代理處理分支、合併、重定基礎、衝突解決以及團隊協作模式。
架構
記憶存放在 ~/git/。結構請參閱 memory-template.md。
~/git/
└── memory.md # 使用者偏好 (選用)
快速參考
| 主題 | 檔案 |
|---|---|
| 基本指令 | commands.md |
| 進階操作 | advanced.md |
| 分支策略 | branching.md |
| 衝突解決 | conflicts.md |
| 歷史與復原 | history.md |
| 團隊工作流程 | collaboration.md |
| 設定 | setup.md |
| 記憶 | memory-template.md |
核心規則
- 絕不強制推送至共用分支 — 僅在功能分支上使用
--force-with-lease - 及早提交、頻繁提交 — 小型提交更易於檢視、復原與二分搜尋
- 撰寫有意義的提交訊息 — 首行不超過 72 個字元,使用祈使語氣
- 推送前先拉取 — 推送前務必執行
git pull --rebase以避免合併提交 - 合併前清理 — 使用
git rebase -i壓合修復用的提交
團隊工作流程
功能分支流程:
- 從 main 分支建立
git checkout -b feature/name - 進行提交,定期推送
- 開啟 PR,取得審查
- 壓合後合併至 main 分支
- 刪除功能分支
熱修復流程:
- 從 main 分支建立
git checkout -b hotfix/issue - 修復、測試、提交
- 合併至 main 以及 develop 分支 (若存在)
- 標記版本發行
每日同步:
git fetch --all --prune
git rebase origin/main # 若團隊偏好合併,也可使用 git merge
提交訊息
- 使用慣例提交格式:
type(scope): description - 首行保持在 72 個字元以內
- 類型:
feat,fix,docs,style,refactor,test,chore
推送安全
- 使用
git push --force-with-lease取代--force— 防止覆寫他人工作 - 若推送被拒絕,請先執行
git pull --rebase再重試 - 絕不強制推送至 main/master 分支
衝突解決
- 編輯衝突檔案後,確認無殘留標記:
grep -r "<<<\|>>>\|===" . - 在完成合併前,測試程式碼能正常建置
- 若合併變得太複雜,請使用
git merge --abort中止,並改嘗試git rebase
分支衛生
- 刪除已合併的本地分支:
git branch -d branch-name - 清理遠端追蹤:
git fetch --prune - 建立 PR 前,將功能分支重定基礎至最新的 main 分支
- 使用
git rebase -i在推送前壓合雜亂的提交
安全檢查清單
在執行破壞性操作 (reset --hard, rebase, force push) 之前:
- 這是否為共用分支? → 請勿改寫歷史
- 是否有未提交的變更? → 先暫存或提交
- 是否位於正確分支? → 使用
git branch確認 - 遠端是否為最新? → 先執行
git fetch
常見陷阱
- git user.email 錯誤 — 在重要提交前使用
git config user.email確認 - 空目錄 — Git 不會追蹤它們,請加入
.gitkeep - 子模組 — 務必使用
--recurse-submodules進行複製 - 分離的 HEAD — 使用
git switch -返回前一個分支 - 推送被拒絕 — 通常需要先執行
git pull --rebase - stash pop 發生衝突 — 暫存會消失。請改用
stash apply - 大型檔案 — 對於大於 50MB 的檔案,請使用 Git LFS,絕不提交機密
- 大小寫敏感性 — Mac/Windows 忽略大小寫,Linux 則不忽略 — 導致 CI 失敗
復原指令
- 復原上一次提交但保留變更:
git reset --soft HEAD~1 - 丟棄未暫存的變更:
git restore filename - 尋找遺失的提交:
git reflog(保留約 90 天的歷史) - 復原已刪除的分支:
git checkout -b branch-name <sha-from-reflog> - 當提交混合多個變更時,使用
git add -p進行部分暫存
使用 Bisect 除錯
找出引入錯誤的提交:
git bisect start
git bisect bad # 目前提交有問題
git bisect good v1.0.0 # 此版本正常執行
# Git 會切換至中間的提交,測試它,然後:
git bisect good # 或 git bisect bad
# 重複直到 Git 找到罪魁禍首
git bisect reset # 返回原始分支
快速摘要
git status -sb # 簡短狀態與分支
git log --oneline -5 # 最近 5 筆提交
git shortlog -sn # 依提交次數排列的貢獻者
git diff --stat HEAD~5 # 最近 5 筆提交的變更摘要
git branch -vv # 包含追蹤資訊的分支
git stash list # 待處理的暫存
相關技能
若使用者確認,請使用 clawhub install <slug> 安裝:
gitlab— GitLab CI/CD 與合併請求docker— 容器化工作流程code— 程式碼品質與最佳實務
意見回饋
- 若有幫助:
clawhub star git - 保持更新:
clawhub sync