一个技术负责人应该知道的规范细节

前言:

作为一个技术负责人,不能只定义一个项目的技术选型,而不注意开发细节。
开发前,如果不预先定义好规范,那么项目中就会乱成一锅粥。每个人自成一派,单看每个人的模块,貌似都没啥大问题,但合在一起,就明显感觉是多个人开发的。这个时候,等发发现问题,再让某些人去改的话,一方面容易引起coder的反对,另一方面也会减少技术负责人的威望。因为一般出现这种情况,大部分原因是项目的技术负责人不合格,没有把事情提前想好,也就是所谓的没有经验。

那么,如何才能当一个合格的技术负责人呢?如何去定这些规则呢?

1、git规范

现在开发对于版本控制,最多就是git了,所以以git为例,讲讲通用的规则。
一般线上分支是master,保证上线部署的必须是master分支的代码。
开发总分支是dev分支。
普通的开发分支一般是dev_业务内容,这个其实就没有那么多限制了。
1、新代码开发完成后,本地环境自测,测到通过。
2、然后合到dev后,上测试环境测试,测到通过。
3、最后code review,然后由技术负责人或者指定的一位大佬将dev的代码合到master。
4、master分支上线,上线后再次测试验证。

对于普通的开发人员:

所有关于master的操作一律禁止。
开发完成并且自测通过后,只需要将自己开发分支的代码merge到dev分支,然后将devf分支部署到测试环境,测试通过即可。
所有新分支都从dev分支拉出来,切勿从master分支拉代码。
dev分支,不允许普通的开发人员直接提交。

对于技术负责人或技术负责人指定的开发大牛

负责dev代码的codereview。
负责将dev代码合到master。(gitlab中有merge request,直接审批也可以)

2、数据库规范

数据库相关的,有些事情需要提前规范好。比如:
1、每个表中,都要带有create_time和update_time字段,时间类型。
2、每个表中,都必须有自增id字段,bigint类型。
3、具体业务中,常用单词的英文翻译,需要提前定义好。比如企业员工,有人用user,有人用staff,其实用哪个都可以,重在统一,提前要说好,比如都用user。
4、sql规范,比如查询禁止使用select *,禁止表连接等等。
5、数据的删除,都是逻辑删除,del=1代表已删除,del=0代表未删除,禁止使用delete语句物理删除数据。
6、复杂业务的库表,必须先设计,后开发。技术负责人应该把所有设计都过一遍,避免返工。

3、包结构规范

1、比如项目实体统一放在entity包下,dao层统一放在dao包下,service,controller同理。
2、比如service使用面向接口编程,统一先定义接口,再实现接口。比如userService接口和userServiceImpl实现类。
3、提前给同学们说明项目中dto,vo等对象的含义以及使用场景。
4、提前根据项目要求,提供出一些公共的util,比如文件上传下载,excel导入导出,校验等等,这个不强求,如果项目中开发人员普遍技术水平较高,可由开发同学自己编写,但需要定一套统一的util,避免重复开发。比如excel的导入导出,可能有人用easyexcel,也有人直接用poi,这样poi的包版本就有可能和easyexcel中引用的poi包版本冲突。

4、代码质量检测工具

如果代码量过大,没有人力去codereview,那就要用一些代码检测工具了。比如统一使用CheckStyle插件,也可以自定义一些检查规范。
这个也是代码的终极规范了。但不要完全依赖,只不过是一些明显的错误可以被挖出来了,一些偏业务的坑,还是需要codereview的。
个人经验,基本上看一个人写代码,看他写100行的核心代码,就知道这个人的代码的大概质量了。

发布了203 篇原创文章 · 获赞 186 · 访问量 21万+

猜你喜欢

转载自blog.csdn.net/java_zhangshuai/article/details/104759942