你有沒有過這樣的經歷：幾個月前寫的代碼，現在想回顧某次修改的細節，打開Git提交記錄一看，全是“修改了”“改了一下”“修復bug”這種模糊的描述，根本不知道到底改了啥？或者團隊協作時，別人提交的代碼記錄混亂，想快速找到某個功能的變更，結果翻半天都找不到頭緒？這時候，清晰的Git提交信息（commit message）就派上用場了。
什麼是commit message？¶
每次用 git commit 提交代碼時，你寫的那段說明文字，就是commit message。它就像代碼變更的“日記”，需要簡明扼要地告訴別人（包括未來的自己）：這次提交到底做了什麼？爲什麼這麼做？
爲什麼要寫清晰的commit message？¶
你可能覺得“隨便寫兩句就行”，但清晰的commit message其實有很多隱藏好處：
1. 快速回憶：拯救“失憶”的自己¶
假設你在半年前做了一個項目，現在想優化其中一個功能，打開歷史記錄發現：“commit 1: 修改代碼”“commit 2: 改bug”……完全想不起具體改了啥。但如果commit message是“fix: 修復支付頁面金額計算錯誤”，你一眼就能明白這是針對支付功能的修正，節省大量時間。
2. 團隊協作：讓溝通更順暢¶
團隊裏每個人的提交記錄需要共享。比如前端同事改了登錄頁面樣式，後端同事需要看是哪個提交影響了接口，而清晰的commit message能幫他們快速定位。比如“feat(login): 添加手機號驗證碼登錄”，直接告訴大家：這是新增了驗證碼登錄功能，作用域是login模塊。
3. 自動化工具：讓工具“看懂”你的代碼¶
很多工具依賴commit message自動工作。比如：
- 生成版本日誌（CHANGELOG）：根據不同類型的commit（如fix、feat）自動生成版本更新說明，不需要手動彙總。
- 自動升級版本號：規範的commit message能讓工具判斷版本類型（比如fix對應補丁版，feat對應小版本），自動幫你更新package.json裏的版本號。
4. 快速定位問題：像偵探一樣抓bug¶
如果線上出了bug，需要用 git bisect 快速定位哪次提交導致的。清晰的commit message能幫你快速縮小範圍。比如：“fix(checkout): 修復購物車結算按鈕重複點擊問題”，直接指向問題類型和模塊，比模糊的“改了購物車”快得多。
最簡單的規範：至少包含“類型+描述”¶
剛開始不用追求複雜規範，先養成一個簡單的習慣：明確“這次提交是做什麼的”，最好包含“類型”和“核心內容”。
常見類型（選2-3個基礎的用就行）：¶
fix：修復bug（比如“fix: 修復用戶註冊失敗的問題”）feat：新增功能（比如“feat: 添加商品搜索功能”）docs：文檔更新（比如“docs: 補充API接口說明文檔”）style：格式調整（比如“style: 統一代碼縮進格式”，不影響功能邏輯）refactor：重構代碼（比如“refactor: 將重複的登錄邏輯拆分爲函數”）
示例：¶
# 基礎版
git commit -m "fix: 修復登錄按鈕點擊無反應的問題"
# 進階版（帶作用域，可選）
git commit -m "feat(home): 新增首頁輪播圖組件"
(home)是作用域，說明修改的是home模塊；fix/feat是類型，說明修改的性質；- 後面是簡潔的描述，只寫核心內容，別太囉嗦。
更規範的選擇：Conventional Commits規範¶
如果你想讓commit message更標準化，推薦參考 Conventional Commits 規範。它的格式更嚴格，能被工具自動解析，適合多人協作項目。
核心格式：¶
<類型>[可選作用域]: <描述>
[可選正文]
[可選腳註]
常用類型：¶
feat：新功能（比如“feat: 新增用戶個人中心頁面”）fix：修復bug（比如“fix(auth): 修復驗證碼過期後重新發送功能”）docs：文檔更新（比如“docs: 補充README.md安裝步驟”）chore：日常任務（比如“chore: 更新依賴包版本”，不影響代碼邏輯）
示例：¶
# 帶正文和腳註（可選，進階用）
git commit -m "feat(cart): 新增購物車商品數量修改功能
- 支持+/-按鈕調整數量
- 同步更新總價計算
Fixes #123 # 關聯issue編號，可選"
新手實踐小技巧¶
- 先從“類型+描述”開始：哪怕一開始只用
fix/feat，後面再逐步加作用域和細節。 - 寫在提交前10秒：每次提交前，花10秒想清楚“這次改了啥核心內容”，避免事後回憶不清。
- 用工具輔助：推薦
cz-cli（交互式提交，自動幫你選類型、寫描述），或者commitlint（檢查格式是否合規），安裝後能減少犯錯率。
總結¶
清晰的commit message不是“負擔”，而是提升代碼管理效率的“快捷方式”。它能讓你和團隊成員更快理解代碼變更，也能讓工具幫你自動化處理版本、日誌等瑣事。從今天起，每次提交前花5秒想想“這次要寫什麼”，堅持下去，你會發現代碼倉庫變得更“好懂”了！