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 的好習慣。
發送反饋
請告訴我們您的想法,以幫助我們改進工具。
Feedback is temporarily suspended
The server is busy or spam protection is active. Please try again later.