成人免费xxxxx在线视频软件_久久精品久久久_亚洲国产精品久久久_天天色天天色_亚洲人成一区_欧美一级欧美三级在线观看

在使用Git時你應該這樣提交代碼

系統
目前業內做的比較好的,比較具有參考價值的就是知名前端框架AngularJS的提交規范。

 [[377604]]

1. 前言

目前大部分公司都在使用 Git 作為版本控制,每個程序員每天都要進行代碼的提交。很多開發者也包括我自己,有時候趕時間或者圖省事,就這么提交:

  1. git commit -m "修改bug,優化代碼" 

過了一段,突然去查找一個具體的提交你會發現不是特別好找。因此我們需要規范我們的代碼提交來避免這種情況。同時良好的提交規范也有助于我們生成清晰的 ChangeLog,更利于同事之間的協作。

如果你想成為知名開源項目的貢獻者更要規范自己的代碼提交。

2. Git 提交規范

目前業內做的比較好的,比較具有參考價值的就是知名前端框架AngularJS的提交規范。我們先來看一個例子:

Git提交信息

對應的格式:

  1. <type>[optional scope]: <description> 
  2. # 空行 
  3. [optional body] 
  4. # 空行 
  5. [optional footer] 

更嚴格的項目可能提交要求使用英文描述,特別是國際化的開源項目。

根據上面這個例子我們來了解一下這個業界比較認可的 Git 提交規范。

type

refactor 表示本次提交的是重構代碼,也就是它是一個提交的類型type,除了refactor還有:

  • feat 新功能,顧名思義就是新需求的實現。
  • fix 修復,就是對 bug 的修復。
  • docs 文檔,主要用來描述文檔的變更。
  • style 主要是代碼風格相關的提交,比如格式化等。
  • refactor 重構代碼,對已有功能的重構,但是區別于 bugfix。
  • test 測試相關的提交,不太常用。
  • chore 構建過程或輔助工具的變動,不太常用,比如之前用 Maven,后面換成了 Gradle。

每次提交聲明提交的type是必須的,它讓本次提交的作用一目了然。

scope(可選)

用來表明本次提交影響的范圍,方便快速定位。你可以寫明影響的是哪個模塊(通常是模塊名稱)或者是哪個層(數據層、服務層、還是視圖層)。

subject

就是上面的修改版權信息,是對本次提交的簡短描述概括。就像胖哥寫文章要起一個標題一樣,不要過長。

body(可選)

就是比較詳細描述本次提交涉及的條目,羅列代碼功能,這里胖哥習慣用markdown的列表語法,也就是用中劃線換行隔開條目。當然body不是必選的,如果subject能夠描述清楚的話。

foot(可選)

描述與本次提交相關聯的break change或issue 。

break change

指明本次提交是否產生了破壞性修改,類似版本升級、接口參數減少、接口刪除、遷移等。如果產生了上述的影響強烈建議在提交信息中寫明break change,有利于出問題時快速定位,回滾,復盤。

issue

如果發現項目有 bug、或者有優化的建議、甚至新增一個任務,就可以利用issue給項目提交一個任務。

Git issue

issue不是一些 Git 平臺的專屬功能,JIRA 等平臺也有類似功能,它們的作用大同小異,都可以很好地反應項目的成長狀況和參與度。那么在 Git 提交時,我們可以在foot區域關聯本次提交涉及的issue。

  1. # 涉及issues 
  2. issues  #F12YC,#F45JW 
  3. # 關閉 
  4. Closes #F12YC 

這里沒有固定格式,不過盡量去參考一些知名項目去做。

3. 工具安利

說了這么多,相信你已經對 Git 提交的規范有所了解了。這里推薦一些有用的工具來幫助你將這些規范落實到位。在Intellij IDEA的插件市場有很多 Git Commit Message 模板插件,可以可視化的實現這些規范。

Git提交信息插件

本文轉載自微信公眾號「碼農小胖哥」,可以通過以下二維碼關注。轉載本文請聯系碼農小胖哥公眾號。

 

責任編輯:武曉燕 來源: 碼農小胖哥
相關推薦

2022-04-28 09:02:55

Gitcommitlint配置

2020-11-12 11:55:57

代碼GitJava

2020-11-02 08:21:50

Git辦法代碼

2024-04-08 08:37:41

代碼githook

2021-01-04 13:25:10

Git開源工具

2009-09-14 09:40:48

微軟Linux代碼

2022-09-23 14:44:31

前端huskyeslint

2014-12-18 09:49:31

代碼

2019-12-04 09:05:15

千萬級流量高并發

2019-09-19 09:18:02

API網關互聯網

2012-02-24 09:34:48

SVNGit

2022-10-27 09:34:06

git撤銷

2014-09-23 09:40:09

2013-07-26 11:28:08

Git

2018-07-10 10:45:00

規范Commit項目

2018-07-10 11:05:18

開發者技能命令

2020-02-20 10:45:57

代碼JS開發

2022-11-04 08:22:14

編譯代碼C語言

2011-09-05 17:12:17

2019-03-28 14:30:21

代碼開發命令
點贊
收藏

51CTO技術棧公眾號

主站蜘蛛池模板: 国产精品地址 | 色综合99| 国产一区二区三区在线 | 欧美性大战xxxxx久久久 | 四虎午夜剧场 | 日日摸日日碰夜夜爽亚洲精品蜜乳 | 精品一区二区三区视频在线观看 | 欧美日韩一区在线播放 | 伊人伊成久久人综合网站 | 日韩免费视频一区二区 | 日韩免费高清视频 | 亚洲国产一区二区三区在线观看 | 成人精品在线视频 | 日本成人中文字幕在线观看 | 华人黄网站大全 | 亚洲电影在线播放 | 18gay男同69亚洲网站 | 成人影视网址 | 国产最新网址 | 中文字幕1区 | 人人干人人舔 | 精品国产精品 | 国产偷久久一级精品60部 | 久久久久久免费看 | 国产精品亚洲欧美日韩一区在线 | 国产日韩欧美在线 | 精品国产一级片 | 99re国产精品 | 精品久久久久久久久久久久久久久久久 | 一级在线毛片 | 天天激情综合 | 日韩av中文| 国内在线视频 | 精品亚洲永久免费精品 | 91精品免费视频 | 亚洲一区在线免费观看 | 成人一区二区在线 | 国产精品性做久久久久久 | 日韩在线视频免费观看 | 欧美影院 | 成人欧美一区二区三区在线播放 |