Git 是目前最流行的源代码管理工具。为规范开发,保持代码提交记录以及 git 分支结构清晰,方便后续维护,现规范 git 的相关操作。

分支管理

分支命名

master 分支

master 为主分支,也是用于部署生产环境的分支,确保master分支稳定性

注 意

master 分支一般由develop以及hotfix分支合并,任何时间都不能直接修改代码

develop 分支

develop 为开发分支,始终保持最新完成以及bug修复后的代码

一般开发的新功能时,feature分支都是基于develop分支下创建的

feature 分支

开发新功能时,以develop为基础创建feature分支

分支命名: feature/ 开头的为特性分支, 命名规则: feature/user_module、 feature/cart_module

release分支

release 为预上线分支,发布提测阶段,会release分支代码为基准提测

当有一组feature开发完成,首先会合并到develop分支,进入提测时,会创建release分支。如果测试过程中若存在bug需要修复,则直接由开发者在release分支修复并提交。当测试完成之后,合并release分支到master和develop分支,此时master为最新代码,用作上线。

hotfix 分支

分支命名: hotfix/ 开头的为修复分支,它的命名规则与 feature 分支类似

线上出现紧急问题时,需要及时修复,以master分支为基线,创建hotfix分支,修复完成后,需要合并到master分支和develop分支

常见任务

增加新功能

(dev)$: git checkout -b feature/xxx            # 从dev建立特性分支
(feature/xxx)$: blabla                         # 开发
(feature/xxx)$: git add xxx
(feature/xxx)$: git commit -m 'commit comment'
(dev)$: git merge feature/xxx --no-ff          # 把特性分支合并到dev

修复紧急bug

(master)$: git checkout -b hotfix/xxx         # 从master建立hotfix分支
(hotfix/xxx)$: blabla                         # 开发
(hotfix/xxx)$: git add xxx
(hotfix/xxx)$: git commit -m 'commit comment'
(master)$: git merge hotfix/xxx --no-ff       # 把hotfix分支合并到master,并上线到生产环境
(dev)$: git merge hotfix/xxx --no-ff          # 把hotfix分支合并到dev,同步代码

测试环境代码

(release)$: git merge dev --no-ff             # 把dev分支合并到release,然后在测试环境拉取并测试

生产环境上线

(master)$: git merge release --no-ff          # 把release测试好的代码合并到master,运维人员操作
(master)$: git tag -a v0.1 -m '部署包版本名'  #给版本命名,打Tag

 

日志规范

在一个团队协作的项目中,开发人员需要经常提交一些代码去修复bug或者实现新的feature。而项目中的文件和实现什么功能、解决什么问题都会渐渐淡忘,最后需要浪费时间去阅读代码。但是好的日志规范commit messages编写有帮助到我们,它也反映了一个开发人员是否是良好的协作者。

编写良好的Commit messages可以达到3个重要的目的:

加快review的流程

帮助我们编写良好的版本发布日志

让之后的维护者了解代码里出现特定变化和feature被添加的原因

目前,社区有多种 Commit message 的写法规范。来自Angular 规范是目前使用最广的写法,比较合理和系统化。如下图:

 

Commit messages的基本语法

当前业界应用的比较广泛的是 Angular Git Commit Guidelines

https://github.com/angular/angular.js/blob/master/DEVELOPERS.md#-git-commit-guidelines

具体格式为:

<type>: <subject>
<BLANK LINE>
<body>
<BLANK LINE>
<footer>

type: 本次 commit 的类型,诸如 bugfix docs style 等

scope: 本次 commit 波及的范围

subject: 简明扼要的阐述下本次 commit 的主旨,在原文中特意强调了几点 1. 使用祈使句,是不是很熟悉又陌生的一个词,来传送门在此 祈使句 2. 首字母不要大写 3. 结尾无需添加标点

body: 同样使用祈使句,在主体内容中我们需要把本次 commit 详细的描述一下,比如此次变更的动机,如需换行,则使用 |

footer: 描述下与之关联的 issue 或 break change,详见案例

Type的类别说明:

  • feat: 添加新特性
  • fix: 修复bug
  • docs: 仅仅修改了文档
  • style: 仅仅修改了空格、格式缩进、都好等等,不改变代码逻辑
  • refactor: 代码重构,没有加新功能或者修复bug
  • perf: 增加代码进行性能测试
  • test: 增加测试用例
  • chore: 改变构建流程、或者增加依赖库、工具等

Commit messages格式要求

# 标题行:50个字符以内,描述主要变更内容
#
# 主体内容:更详细的说明文本,建议72个字符以内。 需要描述的信息包括:
#
# * 为什么这个变更是必须的? 它可能是用来修复一个bug,增加一个feature,提升性能、可靠性、稳定性等等
# * 他如何解决这个问题? 具体描述解决问题的步骤
# * 是否存在副作用、风险? 
#
# 如果需要的化可以添加一个链接到issue地址或者其它文档

下面给大家分享出来这份大牛力荐的《完全学会Git GitHub Git Server的24堂课》

  • .针对项目开发人员:以最有效率的方式,引导你在实践中完整地学习Git的操作技巧和应用。
  • 对项目管理者:在实例中学习如何查看项目开发的名种统计图,以便随时掌握项目开发的状况。
  • 针对MIS人员:提供建立Git Server的多种玩法,自行选用和规划最适合自己实际运用的方法。

内容简介

本书以教科书的方式,循序渐进地向软件开发人员或软件开发的项目管理人员,讲述如何快速掌握分布式版本控制系统Git的应用方法,让繁琐复杂的项目开发的版本控制变得高效且轻松自如。书中细致入微地介绍了如何使用设置文件和操作Git文档库,以及建立项目开发的分支、合并分支和解决冲突的操作:在具备扎实的基础之后,介绍了Git GUI程序用法,以及Git在团队开发模式中应用的问题:讲述如何与全球的项目开发人员进行交流,提升程序开发的经验和能力:介绍了GitHub、 Bitbucket、 GitLab等提供Git服务的网站;本书最后的重点为介绍架设Git Server 的几种方法,让每一个项目开发团队,可以按照自己的软硬件环境,选择适合的方式来控管项目开发。

目录章节展示

第一部分Git 的基本概念和操作

第1课Git、谁与争锋

 

第2课Gi t配置文件的妙用

 

第3课把文件存入Gi t文档库

 

第4课比较文件的差异和从Gi t文档库取回文件

 

第5课Gi t程序项目管理的实践演练

第6课获取Git文档库统计数据和绘制统计图表

 

第二部分建立分支、合并和解决冲突

第7课程序项目的分支(Br anch)

 

第8课合并程序项目的分支和解决冲突

 

第9课使用Rebase指令更新分支的起始点

 

第10课 程序项目的分支和合并的实践演练

 

第三部分Git 程序的图形操作介面

第11课Git GUI程序的基本功能

 

第12课使用Git GUI程序创建分支和合并

第13课Smar tGi t程序操作介绍

 

第14课sourceTree程序操作介绍

 

第15课TortoiseGi t程序操作介绍

 

第四部分远程 Git文档库和团队开关模式

第16课 “远程Gi t文档库”的基础操

 

第17课“远程Gi t文档库”的高级操作

第18课Gi tHub让程序项目飞上云端

 

第19课F ork让Gi t文档库分家后再合并

 

第20课Bi tbucket比Gi tHub更好用

 

第21课Gi tLab完全免费再加送整个系统

 

第五部分架设 Git Server

第22课使用Windows共享文件夹或 是Git Daemon作为Git Server

 

第23课 使用TTP/HTTPS访问Git Serv er

 

第24课使用SSH认证和加密的Git seryr er

 

需要获取这份资料的小伙伴可以转发+关注后私信(学习)即可免费获取!

 

 

 

 

 

 

内容就不给大家一一展示了,需要获取这份PDF的小伙伴可以直接转发+关注后私信(学习)即可免费获取!