# [Git] Conventional Commits 規範性提交
## 什麼是 Conventional Commits?
Conventional Commits 是一種對 Git commit 訊息的格式化慣例,旨在提供一組清晰的規則,使得提交的歷史更容易被理解,並且可以自動生成如更新日誌或者版本號。
## Conventional Commits 的結構
一個 Conventional Commit 訊息由三部分組成:類型、主題和可選的正文。
* 類型:這是 commit 的類型,例如
* feat(新功能):新增一個新功能。例如:`feat: add search functionality`
* fix(修復 bug):修復一個 bug。例如:`fix: correct typo in login screen`
* docs(文檔變更):只改變了文件。例如:`docs: update README with project setup instructions`
* style(不影響代碼邏輯的變更,如格式化):不影響代碼運行的變動 (空白、格式化等)。例如:`style: format code with prettier`
* refactor(重構代碼):既不是修復 bug 也不是添加新功能的代碼變動。例如:`refactor: simplify API request logic`
* perf(性能優化):提高代碼性能的變動。例如:`perf: improve login page load time`
* test(添加或修改測試):添加或修改測試。例如:`test: add unit test for login function`
* chore(對構建過程或輔助工具的變更):對構建過程或輔助工具和庫的變動。例如:`chore: update project dependencies`
* 主題:這是一個簡短、清晰的描述,說明 commit 做了什麼。
* 正文(可選):如果需要,可以提供更詳細的說明。這裡可以解釋為什麼進行這些變更,這些變更的具體影響,以及任何可能的副作用。
## 結語
Conventional Commits 提供了一種統一的方式來撰寫 commit 訊息,使得其他開發者更容易理解 commit 的目的,並且可以利用工具自動生成更新日誌或者確定版本號。希望這篇文章能幫助你理解並開始使用 Conventional Commits。