git规范指南

一、分支与命名规则说明

1.1、Git 分支类型

master 分支（主分支） 稳定版本

develop 分支（开发分支） 最新版本

release 分支（发布分支） 发布新版本（预发布版本，可不用）

hotfix 分支（热修复分支） 修复线上Bug

feature 分支（特性分支） 实现新特性,新需求

1.2、命名规则

示例施工宝：

sgb (原master分支)

sgb-develop （开发分支）

sgb-feature （新功能分支）

sgb-2.2.1-hotfix （修复线上bug）

项目分支命名

sgb-fangte （方特项目）

sgb-zhihe （致和项目）

jiake-master，jiake-develop （佳科项目）

ynkeenly-master，ynkeenly-develop （佳科项目）

1.3、readme规范

新建项目必须在根目录下新建xx-readme.md，例如jiake-readme.md，以日期或者版本来维护每次更新内容，示例如下：

2.0.28.1 2020-10-23 update by blueeyedboy
员工信息查询：专职业资格列表SQL zsj 2020-10-21 11:41
提交本地代码并且获取最新代码 zsj 2020-10-21 11:38
员工信息查询专职业资格列表SQL zsj 2020-10-21 10:55

二、分支简明使用流程

2.1 使用流程

   (1) 初始化

开发主管提交代码初始版本到master 分支，公司命名为sgb（以下说的master分支指sgb）。

开发主管在master 分支上创建develop 分支（开发分支），master 分支与develop 分支一样，有且仅有一个；命名为sgb-develop。

(2) 开发新功能

当有新需求或新的研究时创建一个feature 分支；从develop分支拉取，命名为sgb-develop-feature;

开发人员从sgb-develop-feature分支中checkout一个新的分支用于开发新功能，命名为 sgb-feature-新功能特性-用户名；如：sgb-feature-meterial-linjun；

(3) 发布测试和发布版本

开发人员开发完毕后，合并到feature分支，feature打包测试，测试通过，将代码合并回develop分支。

master（即sgb）合并develop分支代码，发布新版本sgb-2.1.1-时间tag，如：sgb-2.1.1-20201010。

(4) 线上修复

从某个线上版本上checkout 一个分支用于修复线上bug，如：sgb-2.1.1-20201010 上 checkout 一个新分支 sgb-2.1.1-hotfix

直接hotfix分支打包测试，测试通过后发布一个新版本，如：sgb-2.1.1.1-20201011，并将hotfix合并到master分支，然后删除hotfix分支。

(5) 项目分支，示例方特项目

从master或者某一版本上 拉取一个新分支用于项目开发，如：sgb-2.1.1-20201010 上 checkout –个新分支 sgb-fangte

在项目分支上，如：sgb-fangte 上拉取分支 sgb-fangte-develop 用于开发，同时拉取hotfix分支，用于修复目前存在的bug

从开发分支上拉取一个新分支用于开发新功能特性，如：sgb-fangte-develop 拉取分支 命名为sgb-fangte-feature

开发人员从sgb-fangte-feature分支中checkout一个新的分支用于开发新功能，命名为 sgb-fangte–feature-新功能特性-用户名；如：sgb-fangte–feature-ims-linjun；

开发人员开发完毕后，合并到feature分支，feature打包测试，测试通过，将代码合并回develop分支。

项目主分支（sgb-fangte）合并develop分支代码，发布新版本sgb-fangte-2.1.1-时间tag，如：sgb-fangte-2.1.1-20201017。

在线上版本上checkout 一个分支用于修复线上bug，如：sgb-fangte-2.1.1-20201017 上 checkout 一个新分支 sgb-fangte-2.1.1-hotfix

hotfix分支打包测试，测试通过后发布一个新版本，如：sgb-2.1.1.1-20201011，并将hotfix合并到项目主分支(sgb-fangte)，然后删除hotfix分支。

2.2 git思维导图

以上流程参考以下思维图

三、目前git仓库情况

3.1 移动端

Master分支 改为sgb

sgb-v2版本，最新为v2.1.14

sgb-v3版本，最新为v3.1.4，即将发布 3.2.0 （物资库）

方特项目fangte-1.0.1，基于v2.1.1 分支

线上修复，目前分支 hotfix-v3.1.4

新特性，v3.2.0-20201014,需要合并v3.2.0-20201014-linjun 代码