Git Commit 訊息產生器
透過圖形介面輕鬆產生符合 Conventional Commits 規範的訊息。
支援表情符號 (Gitmoji)、即時字數檢測與一鍵複製。
✨ 產生結果
關於本工具
這是一個視覺化的 Git 提交訊息輔助工具。它能幫助開發者快速套用 Conventional Commits 規範,透過圖形介面依序點選 Type、Scope、填入 Subject,並可自由開啟 Gitmoji 表情符號。完成後只需一鍵複製,就能直接貼到終端機或是 Git GUI 工具中。所有資料處理皆在瀏覽器本地端完成,兼顧便利與隱私。
使用方法
選擇提交類型
從 11 種標準類型中選擇:feat (新功能)、fix (修 Bug)、docs、style、refactor 等。
撰寫標題與內容
在 Subject (標題) 簡短描述變更重點。若需詳細說明,可切換到 Body (內容) 頁籤填寫。
複製與套用
確認下方產生的結果無誤後,點擊「複製內容」,然後貼上到您的 Git 提交介面即可。
名詞解釋
- Conventional Commits
- 一種結構化提交訊息的規範,格式通常為:<type>(<scope>): <description>。好處是有利於後續自動產生 CHANGELOG 或是判定版號跳號原則 (SemVer)。
- Gitmoji
- 在 Commit 標題的最前面加上特定的 Emoji,用以視覺化區分變更類型。例如:✨ = feat, 🐛 = fix。
- Subject (標題)
- Commit 訊息的第一行。社群慣例建議長度不超過 50 個字元。應以祈使句簡短描述「這次做了什麼變更」。
- Body (內容)
- 變更的詳細說明,必須與 Subject 之間空一行。建議每行不超過 72 個字元以利終端機閱讀。
- Footer (結尾)
- 用於標註關聯的 Issue 號碼 (如 Closes #123) 或是宣告破壞性變更 (BREAKING CHANGE)。
- Scope (範圍)
- 選填的關鍵字,標示本次變更影響的模組或範圍。例如:feat(auth) 代表這是認證模組的新功能。
- BREAKING CHANGE (破壞性變更)
- 指本次修改會導致舊有功能無法相容運作。通常會在 type 後面加上驚嘆號 (!) 或在 Footer 明確標示。
- SemVer (語意化版本)
- Semantic Versioning。搭配 Conventional Commits 規範,可透過工具自動判斷下個版本是跳 Major、Minor 還是 Patch。
常見問題
- Q.我輸入的內容會被傳送到伺服器嗎?
- 不會。所有的訊息產生過程都在您的瀏覽器本地端執行,您的程式碼變更與提交內容絕對不會外流到任何外部設備。
- Q.可以自訂 Commit Type (提交類型) 嗎?
- 本工具目前內建最常用的 11 種 Conventional Commits 標準類型。若您團隊有特殊自訂的類型,您可以先產生後,再手動修改輸出的結果。
- Q.該如何將此工具與 Git Hook 搭配使用?
- 您可以結合此工具與 commitlint (透過 commit-msg hook),來確保團隊中所有人送出的 Commit 都符合一致的規範。
- Q.是否有 VS Code 擴充套件版本?
- VS Code 生態系中已有像是 Commitizen 這類的套件。本工具的優勢在於:無需安裝任何套件,隨開即用,跨環境皆可快速操作。
- Q.提交訊息可以使用中文撰寫嗎?
- 可以的!此工具完全支援任意語言輸入。請依照您團隊的語言習慣 (全英文或中英夾雜) 來撰寫 Subject 與 Body 即可。
使用場景
提升 Code Review 效率
統一且結構化的 Commit 訊息,能讓負責 Review 的同事一眼看出每次 Commit 的重點與意圖。
自動產生 CHANGELOG
只要團隊確實遵守 Conventional Commits,未來便能無縫導入 conventional-changelog 等工具自動生成發版紀錄。
新進成員培訓
透過視覺化與選項引導的方式,幫助剛加入團隊的工程師快速適應並寫出符合公司規範的 Commit。
培養良好的 Git 習慣
在輸入時會即時提醒 50/72 字數限制,幫助開發者養成言簡意賅撰寫 Commit 的好習慣。
Send Feedback
Please let us know your thoughts to help us improve the tool.
Feedback is temporarily suspended
The server is busy or spam protection is active. Please try again later.