Conventional Commits
約定式提交(提交訊息規範)
01你是不是遇到這個 / THE SYMPTOM
團隊每個人寫的 commit 訊息都亂七八糟,有的寫「更新」有的寫「fix」,想要一套統一格式,最好還能自動生出更新日誌、自動判斷版本號要怎麼跳。
↑ 如果你點頭了,你要的關鍵字就是 Conventional Commits。
02這是什麼 / DEFINITION
Conventional Commits 是一套 commit 訊息的書寫規範,要求用固定前綴標示變更類型(如 feat: 新功能、fix: 修錯、docs: 文件、chore: 雜項),讓提交訊息能被工具讀懂、自動生成 changelog 與版本號。
03什麼時候用 / WHEN TO USE
團隊要統一提交訊息風格時;想接自動化工具(如 semantic-release)依提交類型自動發版、自動產生更新日誌時。
04怎麼跟 AI 說 / HOW TO ASK
直接複製這句、貼進 Claude Code / Cursor / Copilot / ChatGPT:
幫我把這次的提交訊息改成符合 Conventional Commits 格式,這是修一個登入的 bug,請用正確的 type 前綴。
05常見坑 / WATCH OUT
⚠ type 後面加 ! 或在內文寫 BREAKING CHANGE: 代表破壞相容性,會讓自動發版工具跳主版本——別亂加。它只規範「訊息格式」,跟版本號實際怎麼跳是搭配 Semantic Versioning 一起用的兩件事。
06相關的詞 / RELATED