企业Git 规范的必要性

简介: 既然认同需要一份 Git 规范,那么这个规范需要规范哪些内容,解决哪些问题

677777.png

一、Git 规范的必要性

既然认同需要一份 Git 规范,那么这个规范需要规范哪些内容,解决哪些问题

分支管理

代码提交在应该提交的分支

随时可以切换到线上稳定版本代码多个版本的开发工作同时进行

提交记录的可读性

准确的提交描述,具备可检索性

合理的提交范围,避免一个功能就一笔提交

分支间的合并保有提交历史,且合并后结果清晰明了避免出现过多的分叉

团队协作

明确每个分支的功用,做到对应的分支执行对应的操作

合理的提交,每次提交有明确的改动范围和规范的提交信息使用 Git

管理版本迭代、紧急线上 bug fix、功能开发等任务

二、分支管理

分支命名

master 分支

master 为主分支,主分支,永远处于稳定状态,对应当前线上版本

以 tag 标记一个版本,因此在 master 分支上看到的每一个 tag 都应该对应一个线上版本

master

分支一般由develop以及hotfix分支合并,任何时间都不能直接修改代码不允许在该分支直接提交代码

develop 分支

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

包含了项目最新的功能和代码, 所有开发都依赖 develop 分支进行

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

小的改动可以直接在 develop 分支进行,改动较多时切出新的 feature 分支进行

推荐的做法: develop

分支作为开发的主分支,也不允许直接提交代码。小改动也应该以 feature

分支提 merge request 合并,目的是保证每个改动都经过了强制代码

review,降低代码风险

feature 分支

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

feature/cart_module

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

开发新的功能或者改动较大的调整,从 develop 分支切换出 feature

分支,分支名称为

开发完成后合并回 develop 分支并且删除该 feature/xxx 分支

release分支

发布分支,新功能合并到 develop 分支,准备发布新版本时使用的分支, 预发布

发布之前发现的 bug 就直接在这个分支上修复,确定准备发版本就合并到 master 分支,完成发布,同时合并到 develop 分支

当有一组feature开发完成,首先会合并到develop分支,当 develop

分支完成功能合并和部分

bug

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

hotfix 分支

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

当线上版本出现 bug 时,从 master 分支切出一个 分支,完成 bug 修复,然后将

合并到 master 和 develop 分支(如果此时存在 release 分支,则应该合并到

release

分支),合并完成后删除该 分支

以上就是在项目中应该出现的分支以及每个分支功能的说明。

其中稳定长期存在的分支只有 master 和

develop

分支,别的分支在完成对应的使命之后都会合并到这两个分支然后被删除。简单总结如下:

master 分支: 线上稳定版本分支

develop 分支: 开发分支,衍生出 feature 分支和 release 分支

release 分支: 发布分支,准备待发布版本的分支,存在多个,版本发布之后删除

feature 分支: 功能分支,完成特定功能开发的分支,存在多个,功能合并之后删除

hotfix 分支: 紧急热修复分支,存在多个,紧急版本发布之后删除

三、Git日志规范

四、分支提交操作建议

分支间操作注意事项

在团队开发过程中,避免不了和其他人一起协作,同时也会遇到合并分支等一些操作,这里提交

2 个个人觉得比较好的分支操作规范。

同一分支 使用 rebase

默认的

行为是 merge,可以进行如下设置修改默认的

行为:

不要在公共分支使用rebase

本地和远端对应同一条分支,优先使用rebase,而不是merge 关于使用rebase 还是

merge

git rebase

git merge

个人推荐大家开发的时候,尽量及时rebase上游分支(我习惯是每周merge一次),有冲突提前

就fix掉,即使我们自己的分支开发了很久(哪怕是几个月),也不会积累太多的conflict,最后合并进主分支的时候特别轻松,

非常反对从master

check出新分支,自己闷头开发几个月,结果最后merge进主分支的时候,一大堆冲突,自己还嗷嗷叫的行为

尽量及时rebase上游分支,发现有冲突,merge

分支冲突解决建议

  1. 首先使用git status
    分析原因,是哪个文件出现了冲突,可以使用文本编辑器打开该文件。冲突产生后,冲突文件会显示以下标记<<<<<<<
    与======= 之间是本地修改的内容, ======= 与

>>>>>>> 之间是远程修改的内容。

根据这个,对冲突文件进行编辑,在修改完之后,

重新commit以下就可以了

  1. 如果我们确定远程的分支正好是我们需要的,而本地的分支上的修改比较陈旧或者不正确,那么可
    以直接丢弃本地分支内容,运行如下命令(看需要决定是否需要运行git
    fetch取得远程分支):
  2. 如果我们觉得合并以后的文件内容比价混乱,想要废弃这次合并,回到合并之前的状态,那么可以
    运行如下命令:

rebase过程中出现的冲突

在rebase的过程中,也许会出现冲突(conflict).

在这种情况,Git会停止rebase并会让你去解决 冲突;

在解决完冲突后,用"git-add"命令去更新这些内容的索引(index), 然后,你无需执行

git-commit,只要执行:

这样git会继续应用(apply)余下的补丁

在任何时候,你可以用--abort参数来终止rebase的行动,并且"mywork"

分支会回到rebase开始前的状态。

五、最佳实践

设置好自己的提交用户名和邮箱

新功能重新建立功能分支

当您继续开发功能分支时,请经常根据master 分支对其进行重新设置。

这意味着要定期执行以下步骤,

这些步骤会在功能分支中重写历史记录 (这不是一件坏事)。

首先,它使您的功能分支看起来像master 并进行了所有更新以达到master 要求。

然后,您对功能分支的所有提交都会在顶部重放,因此它们会顺序出现在Git日志中。

您可能会在一路上遇到需要解决的合并冲突,这可能是一个挑战。

但是,这是处理合并冲突的最佳方法,因为它只会影响功能分支。

解决所有冲突并进行回归测试之后,如果准备好将功能部件合并回master

,请再执行一次上述变基步骤,然后执行合并,

在此期间,如果其他人推动更改以master 与您的冲突,则Git合并将再次发生冲突。

您需要解决它们并重复进行回归测试

使用标签

完成测试并准备从master

分支部署软件后,或者如果出于其他任何原因想要将当前状态保留为重要的里程碑,请创建Git标签。分支积累与提交相对应的更改历史记录时,标签是该时刻分支状态的快照。

可以将标签视为无历史记录的分支,也可以将其视为指向创建标签之前特定提交的命名指针。配置控制

是关于在各个里程碑保留代码状态。

能够复制任何里程碑的软件源代码,以便在大多数项目中都可以在需要时进行重建。

Git标签为此类代码里程碑提供了唯一的标识符。 标记很简单:

考虑一种方案,其中与给定Git标签相对应的软件已分发给客户,并且客户报告了问题。

尽管存储库中的代码可能会继续发展,但通常需要回到与Git标签相对应的代码状态,以准确地再现客户问题以创建

错误修复程序。 有时,较新的代码可能已经解决了该问题,但并非总是如此。

通常,您需要签出特定标签并从该标签创建分支:

目录
相关文章
|
3月前
|
敏捷开发 测试技术 持续交付
阿里云云效产品使用合集之如何将个人账号下的Git仓库转移到企业账号下
云效作为一款全面覆盖研发全生命周期管理的云端效能平台,致力于帮助企业实现高效协同、敏捷研发和持续交付。本合集收集整理了用户在使用云效过程中遇到的常见问题,问题涉及项目创建与管理、需求规划与迭代、代码托管与版本控制、自动化测试、持续集成与发布等方面。
|
6月前
|
人工智能 缓存 开发工具
结合企业实践来规范你的Git commit(含插件使用指南)
结合企业实践来规范你的Git commit(含插件使用指南)
结合企业实践来规范你的Git commit(含插件使用指南)
|
3月前
|
消息中间件 小程序 Java
【规范】看看人家Git提交描述,那叫一个规矩
本文通过IDEA中的Git描述规范插件【git commit message helper】,介绍了Git提交描述的规范流程,强调了团队开发中统一标准的重要性,并通过实例展示了规范的提交记录如何提高代码管理和维护效率。最后,文章提供了几个实用的Git提交描述案例,帮助读者更好地理解和应用这些规范。
83 0
【规范】看看人家Git提交描述,那叫一个规矩
|
3月前
|
敏捷开发 小程序 持续交付
【规范】Git分支管理,看看我司是咋整的
本文介绍了Git分支管理规范的重要性及其在企业中的应用。通过规范化的分支管理,可加速团队协作、确保代码质量、维护主分支稳定,并支持敏捷开发。文中详细描述了主分支(如master、develop)和辅助分支(如feature、hotfix)的作用,并提供了实际开发流程示例,包括开发前、开发中、提测、预生产和部署上线等阶段的操作方法。旨在帮助团队提高效率和代码质量。
189 0
【规范】Git分支管理,看看我司是咋整的
|
3月前
|
开发工具 git
Git——commit的提交规范
Git——commit的提交规范
106 4
|
3月前
|
JavaScript 测试技术 开发工具
Git 分支设计规范
Git 分支设计规范
197 11
|
3月前
|
存储 测试技术 开发工具
企业Git 规范的必要性-阿里云开发者社区
既然认同需要一份 Git 规范,那么这个规范需要规范哪些内容,解决哪些问题。
|
3月前
|
监控 程序员 开发工具
如何规范Git提交-参考阿里云开发者社区
这篇文章分享了如何规范Git提交,介绍了commit message的格式规范,并通过webhook监控机制来确保代码提交的规范性,从而提高研发效率和代码维护质量。
|
3月前
|
开发工具 git
Git——简单的分支规范
Git——简单的分支规范
42 0
|
4月前
|
测试技术 开发工具 git
git 提交规范
git 提交规范
172 2