⚡ Conventional Commits 訊息產生器

依 Conventional Commits 規範產生格式完整的 Git 提交訊息。選擇 type、填寫 scope 與說明，選填 body、footer，支援破壞性變更標記與 emoji，一鍵複製到剪貼簿。

什麼是 Commit 訊息產生器？

Commit 訊息產生器依 Conventional Commits 規範，協助你產生格式完整、一致的 Git 提交訊息。你選擇 type（如 feat、fix）、填寫 scope 與說明，選填 body 與 footer，工具就會組成符合規範的 commit message。規範化的提交訊息能讓 Git 歷史更清楚、方便自動產生 changelog。

對團隊協作與長期維護的專案，一致的 commit 格式能大幅提升可讀性，也讓版本管理工具更好運作。

適用情境

如何使用

  1. 選擇提交類型 type（feat、fix、docs 等）。
  2. 填寫影響範圍 scope 與簡短說明。
  3. 選填詳細的 body 與 footer（如 BREAKING CHANGE）。
  4. 複製產生的完整 commit message。

使用技巧

名詞解釋

Conventional Commits
一套標準化 commit 訊息格式的規範，如 type(scope): subject。
type
提交的類型，如 feat（功能）、fix（修補）、docs（文件）。
BREAKING CHANGE
標示破壞相容性的重大變更，影響版本號。

常見問題 FAQ

什麼是 Conventional Commits 規範？

Conventional Commits 是一套 Git 提交訊息的輕量規範，格式為 type(scope)!: description。透過固定的 type 前綴（如 feat、fix），工具可以自動產生 CHANGELOG、決定語意化版本號（SemVer）。feat 對應 MINOR 版本升級，fix 對應 PATCH 升級，有 BREAKING CHANGE 或 ! 則升 MAJOR 版本。這套規範已廣泛應用於 Angular、Vue、React 等主流開源專案。

什麼時候要勾選「破壞性變更（Breaking Change）」？

當你的提交包含與前一版不相容的 API 變更時，應勾選此選項。例如：重新命名函式參數、移除回應物件中的欄位、改變現有功能的行為需要呼叫端更新程式碼。勾選後會在 type/scope 後加上 ! 符號（如 feat!），並在 footer 加入 BREAKING CHANGE 說明，提示自動化工具升級 Major 版本號。

Body 和 Footer 欄位分別填什麼？

Body 用來對本次變更做更詳細的說明，特別是「為什麼這樣做」，適合在簡短說明不足以表達時使用。Footer 用來放 metadata，例如相關 Issue 引用（Closes #123、Refs #456）、共同作者（Co-authored-by: Name <email>）或破壞性變更的詳細說明。Footer 必須與 Body 之間以空行分隔。

各個提交類型分別適合用於哪些情境？

feat 新功能、fix 修正 Bug、docs 僅修改文件（README 等）、style 格式調整（空白、縮排，不影響邏輯）、refactor 重構（不新增功能、不修 Bug）、perf 效能改善、test 新增或修改測試、build 修改建置系統或套件依賴、ci 修改 CI 設定（GitHub Actions 等）、chore 其他例行維護任務、revert 還原先前的提交。

Conventional Commits 是什麼？

一套標準化 commit 訊息格式的規範，基本結構為 type(scope): subject，例如 feat(auth): add login。它讓 Git 歷史更清楚，也方便工具自動產生 changelog 與版本號。

有哪些常見的 type？

常見有 feat（新功能）、fix（修 bug）、docs（文件）、style（格式）、refactor（重構）、test（測試）、chore（雜項）等。

什麼時候標 BREAKING CHANGE？

當變更會破壞既有相容性（如 API 介面改變）時，在 footer 標註 BREAKING CHANGE，提醒使用者並影響主版本號。

資料會上傳嗎？

不會。訊息在你的瀏覽器本機產生，內容不會上傳或儲存。