一、代碼提交規範fix
1、使用明確的問題描述作為commit message的開頭,使用祈使語氣下達指令
例如:Fix the bug that caused the app to crash when tapping the login button
2、如果commit修復了某個issue,應該在commit message中明確指出該issue的編號或名稱
例如:Fix issue #123: Unable to upload image to server
3、commit message應該被寫成小於50個字元的總結類信息。對於詳細的描述,使用更換行來進行分割。
例如:
Fix the bug that caused the app to crash when tapping the login button
This bug was caused by the wrong configuration of the server setting
二、代碼提交規範怎麼寫
1、提供清晰明確的說明文檔,在其中定義commit message的格式要求,以及每種message的具體要求。提供開發者可以參考的commit message的範例
例如:
feat: 新增了搜素頁的UI設計
fix: 修復了不能登錄的bug
docs: 更新文檔
refactor: 重構了用戶賬戶的邏輯實現
test: 增加了使用手冊中的案例
2、在代碼提交的過程中,需要密切關注代碼的風格。需要定義代碼書寫規範,並儘可能地應用到所有的代碼中去。
例如:避免代碼重複、盡量簡化函數和變數命名、注釋、縮進等幾個方面來規範主要的代碼書寫規範
三、代碼提交規範文檔
1、代碼提交規範的文檔應該涵蓋以下重要內容:
– 定義不同種類的commit message
– 提供commit message的格式要求
– 提供關於代碼風格規範的建議和最佳實踐的相關信息
– 提供commit的流程以及要遵守的時間節點
– 指定代碼審查的流程和質量測量標準
2、文檔應該提供示範和樣例,使開發人員能夠更好地了解代碼提交規範以及如何有效地應用規範
四、代碼格式規範
1、使用空白符來調整代碼的排版,每個縮進級別使用4個空格作為標準
例如:
<div>
<p>some text</p>
</div>
2、所有的變數、函數名稱和關鍵字等都應該使用統一的大小寫格式。在一個文件中保持一致的代碼樣式非常有助於代碼的可讀性
3、在代碼行的結尾處使用分號,這樣可以更清晰地表示出一些代碼塊的結束
五、git提交代碼規範
1、在本地分支完成相關開發工作後,合理的commit、push推送到遠程倉庫
例如:git commit -m “feat: 新增了搜素頁的UI設計”,git push等命令
2、當修改已經提交到倉庫時,需要遵循相應的流程來去提交代碼。主要包括以下幾個步驟:
– 從目標倉庫中拉取新的信息
– 創建一個新的分支,並在開發過程中進行提交
– 提交一個merge request(拉請求)
– 將代碼進行審查
– 將代碼合併到主分支
六、如何規範的提交代碼
1、在代碼提交前,應該仔細地檢查所有的代碼和注釋,以便發現是否有意外的錯誤發生
例如:檢查代碼風格、命名規範是否符合規範
2、所有提交信息應該包含明確簡潔的摘要和詳細的描述,以便其他開發人員了解該修改的原因以及對其進行修改的情況
3、在提交代碼之前,需要確保代碼的可測試性以便測試人員能夠對更改進行充分的測試,並檢測是否滿足最初的開發需求
七、git提交代碼順序步驟
1、檢查本地代碼的更改狀態,並和遠程倉庫同步
例如:git fetch線上倉庫的主幹分支,與本地倉庫所在分支合併
2、使用git branch命令來查看當前分支狀態
例如:git branch
3、使用git checkout命令把本地分支轉換到目標分支
例如:git checkout feature/xx
4、使用git pull命令同步目標分支到本地倉庫
例如:git pull
5、在本地分支中提交更改
例如:git add ., git commit -m “feat: 新增了搜素頁的UI設計”
6、推送到遠程倉庫
例如:git push origin feature/xx
原創文章,作者:HLRF,如若轉載,請註明出處:https://www.506064.com/zh-tw/n/146464.html