完整Git开发规范
分支策略¶
1. master主分支,用于生产环境的主分支
2. test分支,用于测试环境分支,一般可以自动CICD
3. release分支,用于生产环境分支,只能通过master合并进入
4. fix/ 分支,用于修补线上bug分支
5. feat/ 分支,用于开发功能分支
6. refactor/ 分支,用于重构代码
7. 禁止使用姓名缩写命名分支*
三大环境¶
- 生产环境 > 用于部署成品的环境,master分支 >
- 测试环境 > 用于部署测试,test分支 >
- 开发环境 > 用于本地进行测试 >
开发流程¶
- git clone remote-url 克隆仓库
- 拉取最新代码
- git fetch origin master:master 不在master
- git pull origin master 在master
- 开发
- 创建新分支
- git checkout -b feat/xxx master 开发新功能
- git checkout -b fix/xxx master 修补bug
- git checkout -b refactor/xxx master 重构
- 推送新分支
- git push origin xxx
- 合并到test分支
> 前提是在开发环境测试没有问题
>
- git fetch origin test:test
- git checkout test
- git merge xxx(自己的分支)
- 没有冲突
- git push 推送分支
- 产生冲突
- git checkout -b merge/xxx test
- 解决冲突
- git merge xxx
- git push origin xxx
- 继续向test合并
- 提出master的merge request(在gitlab中)
> 前提是在测试环境没有问题
>
- 产生冲突和test解决方式类似
- review没有问题,合并分支到master,结束开发
- review出问题
- 继续修改代码,解决问题再次请求合并
- 创建新分支
- 开发完毕,删除分支
- git push origin :xxx(远程分支名字)
- git branch -d xxx(本地分支名字)
注意事项¶
- 提交merge request前必须经过测试环境检验
- test分支代码不能合并到master分支
- test分支可以直接合并,master分支必须经过审核
- 不要在test分支直接进行开发!
- 禁止使用姓名缩写命名分支
- 一旦分支合并入master,请删除分支,避免分支上二次开发
远程分支跟踪¶
- 远程没有分支,本地也没有分支
git checkout -b test //创建并切换到新分支 git push --set-upstream origin test //推送到远程分支,并且跟踪远程分支
- 远程已经存在分支,本地不存在对应分支
git checkout -b newtest origin/test git pull
提交规范¶
格式¶
type(scope) : subject
type¶
- feat: 新特性或功能
- fix: 缺陷修复
- docs: 文档更新
- style: 代码风格或者组件样式更新
- refactor: 代码重构,不引入新功能和缺陷修复
- perf: 性能优化
- test: 单元测试
- chore: 其他不修改 src 或测试文件的提交
scope(optional)¶
- 用于说明 commit 影响的范围,比如数据层、控制层、视图层等等,视项目不同而不同
subject¶
- 简易描述该commit做了什么
MR规范¶
- 在仓库提交mr时候,应该注明修改或者添加了什么功能(相当于提交的总结,需要必commit message详细)
# 示例 1. fix:删除了审核的部分 2. feat:完善了测试环境自动推送脚本