[TOC] #### 1. 前言 --- 每個人 git 的提交記錄都有自己的風格和習慣，特別是多人協作開發(fā)的項目，如果沒有一套完整的規(guī)范，則每個人的代碼提交描述內容會很隨意，質量參差不齊，會降低 log 的可讀性和維護性。所以，需要有一套 git 提交規(guī)范，使得提交記錄清晰明了，讓人一看就能知道每次提交的目的。本文記錄一種業(yè)界比較認可和常用的規(guī)范，來自 AngularJS 團隊規(guī)范 #### 2. 提交規(guī)范 --- 提交描述信息格式: `<type>(<scope>): <subject>` **type: 操作類型** | 類型 | 描述 | | ------------ | ------------ | | add | 新增功能 | | update | 更新功能 | | delete | 刪除功能 | | fix | 修復 BUG | | refactor | 代碼重構 | | revert | 撤銷上次commit | | style | 代碼風格更改 | | docs | 修改文檔相關內容 | **scope: 影響范圍** 用于說明本次 commit 的影響范圍，比如: 具體功能或模塊，控制器層，業(yè)務層，模型層等，視項目不同而不同 ** subject: 簡單描述** 本次 commit 的簡單描述，一般不超過 50 個字符。推薦以動詞開頭: 新增，修改，設置撤銷等等 **規(guī)范的提交信息示例:** ``` add(用戶模塊):新增用戶編輯個人資料功能 update(用戶模塊):修改用戶編輯個人資料不需要上傳頭像 delete(購物車模塊):刪除購物車批量刪除商品功能 fix(購物車模塊):修復購物車商品數量可以為負數 refactor(全部):初始化系統(tǒng)架構 revert(用戶模塊):撤銷修改用戶編輯個人資料不需要上傳頭 style(會員中心):格式化代碼 docs(api):更新API文檔 ``` #### 3. 多行提交內容 --- 多行提交內容模板，我經常使用的模板 ``` git commit -m "fix: 1、 2、 " ``` 在文本編輯器中寫好準備執(zhí)行的提交命令，復制粘貼到命令行中執(zhí)行即可，如下所示： ``` git commit -m "fix:用戶模塊、購物車模塊 1、修復用戶無法注冊功能 2、修復購物車商品批量刪除報錯問題 3、修復積分商城支付成功后訂單狀態(tài)沒有改變問題 " ```