程序员必知必会,CodeReview规范,推荐分享给团队
csdh11 2025-01-26 21:48 50 浏览
1. 为什么需要 Code Review?
Code Review(代码评审)是日常开发中必不可少的步骤,但是一些开发者重视不够,没有体验到Code Review的好处。觉得自己发起的Code Review同事没有认真倾听,同事发起的Code Review又在耽误自己的开发时间。今天一灯就跟一起总结一下Code Review的好处。
1.1 统一代码风格
团队内代码风格的统一,可以增加代码的可读性,便于继任者快速上手。
你看到下面的换行,是什么感觉?
public class UserService {
@Autowired
private UserDao userDao;
/**
* 不规范的换行
*/
public User getUserById(Long userId)
{
return userDao.getUserById(userId);
}
}
1.2 提前发现bug
每个人功能是有限的,不可能考虑的很全面,对业务的理解也不同。其他人可以站在另一个角度,帮助潜在的bug,规避线上问题。
1.3 提高代码质量
有些开发者以完成任务为目的,完全不考虑架构风格,老子就是一把梭。接口层直接调用到数据层,代码调用混乱,重复编写。一个方法几百行,一个类几千行,写完第二天自己也看不懂了。
作为程序员还是需要对代码质量有追求的,很多招聘要求面试者有代码洁癖。雷军说自己写的代码像诗一样优美,咱们普通开发者也要向大佬看齐。
有些经典书籍有助于提升代码质量,像是《重构:改善既有代码的设计》、《代码整洁之道》、《代码大全》等。
1.4 促进知识共享
每次做Code Review,都是在做知识分享、交流学习。梳理自己实现方案,学习别人的架构风格、业务思路,对自己的技术和业务理解也是一种提高。也有助于培养团队内的技术氛围。
1.5 增加业务学习
了解业务上增加了什么新功能,对现有业务的影响是什么,更有助于团队成员之间沟通与协作。
2. Code Review 基本原则
在进行 Code Review 时,应遵循以下基本原则,以确保过程的高效和顺利:
2.1 以交流学习为目的
帮助同事做Code Review的目的是互相交流学习,而不是抓住同事的错误不放,炫耀自己的技术有多强。团队成员之间应该保持开放和积极的态度,互相学习和进步。
2.2 保持客观和专业
保持客观和专业的态度,评审代码的质量和符合规范的程度,而不是评价提交者本人。指出任何错误的时候,都要在对方可接受的范围内。
2.3 及时反馈结果
Code Review 应该是一个及时和持续的过程。审查者应在收到代码提交后尽快进行审查,以避免延误项目进度。同时,提交者在收到反馈后应及时进行修改和回应,以确保问题得到及时解决。审查者在确认修改后,应及时批准代码合并,以保持开发流程的高效运转。
3. Code Review 时机
发起 Code Review 的时机,最好是在需求提测前,这样可以保证Review后做的代码变更,可以被测试覆盖到。
有些开发者喜欢在上线前发起 Code Review ,这样是不对的。谁敢给你做 Code Review ,给你提了审核建议,你也没办法修改,马上就要上线了。
4.Code Review 注意事项
在进行 Code Review 时候,审核者往往不知道从哪下手。可以关注以下几个方面,以提高审查的效果和质量。
4.1 关注代码风格
团队内部最好遵守相同的代码规范,比如:变量命名、常量定义、枚举值定义、代码格式、日期格式化工具、异常处理、注释规范、传参和响应数据包装、建表规约等,参考《阿里Java开发手册》。
4.2 单元测试要求
单元测试是开发者最容易忽略的问题,通常要求新增代码的单测覆盖率至少达到70%。写好单元测试用例可以帮助开发者提高代码质量,减少低级bug,减少调试时间。
4.3 符合架构规范
代码是否符合常见的架构规范,比如:单一职责原则、开闭原则、是否存在跨层调用、是否有重复逻辑、领域边界划分是否合理等。
4.4 代码健壮性
通常只有20%的代码用来实现核心逻辑,而80%的代码用来保证程序安全。
实现了核心逻辑之后,代码的健壮性也是一个不可忽略的指标。可以关注以下几个方面:
- 是否有判空和异常传参校验
- 逻辑边界是否完整
- 是否存在线程安全问题
- 是否存在并发调用问题
- 是否需要支持幂等
- 是否存在内存泄露风险
- 是否有资源边界限制
- 是否存在数据一致性问题
- 是否需要增加限流、熔断、降级等保护机制
- 是否需要兼容旧逻辑、旧版本
4.5 接口性能问题
接口性能也是需要重点关注的问题,可以关注以下几个方面:
- 是否存在循环调用(接口、数据库),能否改成批量处理
- 调用外部接口是否设置合理的超时时间
- 对外开放的接口,是否预估调用量?是否有保护机制(限流、熔断、降级)?
- 是否需要增加本地缓存、分布式缓存、多线程、消息队列
- 打印日志是否过多
4.6 数据安全问题
表现形式为:用户可以访问或者操作不属于自己管理范围内的接口或者接口的数据。
需要关注接口是否需要登录态、参数签名的校验,是否有横向越权和纵向越权的问题,对外暴露的数据需要脱敏处理。
相关推荐
- 探索Java项目中日志系统最佳实践:从入门到精通
-
探索Java项目中日志系统最佳实践:从入门到精通在现代软件开发中,日志系统如同一位默默无闻却至关重要的管家,它记录了程序运行中的各种事件,为我们排查问题、监控性能和优化系统提供了宝贵的依据。在Java...
- 用了这么多年的java日志框架,你真的弄懂了吗?
-
在项目开发过程中,有一个必不可少的环节就是记录日志,相信只要是个程序员都用过,可是咱们自问下,用了这么多年的日志框架,你确定自己真弄懂了日志框架的来龙去脉嘛?下面笔者就详细聊聊java中常用日志框架的...
- 物理老师教你学Java语言(中篇)(物理专业学编程)
-
第四章物质的基本结构——类与对象...
- 一文搞定!Spring Boot3 定时任务操作全攻略
-
各位互联网大厂的后端开发小伙伴们,在使用SpringBoot3开发项目时,你是否遇到过定时任务实现的难题呢?比如任务调度时间不准确,代码报错却找不到方向,是不是特别头疼?如今,随着互联网业务规模...
- 你还不懂java的日志系统吗 ?(java的日志类)
-
一、背景在java的开发中,使用最多也绕不过去的一个话题就是日志,在程序中除了业务代码外,使用最多的就是打印日志。经常听到的这样一句话就是“打个日志调试下”,没错在日常的开发、调试过程中打印日志是常干...
- 谈谈枚举的新用法--java(java枚举的作用与好处)
-
问题的由来前段时间改游戏buff功能,干了一件愚蠢的事情,那就是把枚举和运算集合在一起,然后运行一段时间后buff就出现各种问题,我当时懵逼了!事情是这样的,做过游戏的都知道,buff,需要分类型,且...
- 你还不懂java的日志系统吗(javaw 日志)
-
一、背景在java的开发中,使用最多也绕不过去的一个话题就是日志,在程序中除了业务代码外,使用最多的就是打印日志。经常听到的这样一句话就是“打个日志调试下”,没错在日常的开发、调试过程中打印日志是常干...
- Java 8之后的那些新特性(三):Java System Logger
-
去年12月份log4j日志框架的一个漏洞,给Java整个行业造成了非常大的影响。这个事情也顺带把log4j这个日志框架推到了争议的最前线。在Java领域,log4j可能相对比较流行。而在log4j之外...
- Java开发中的日志管理:让程序“开口说话”
-
Java开发中的日志管理:让程序“开口说话”日志是程序员的朋友,也是程序的“嘴巴”。它能让程序在运行过程中“开口说话”,告诉我们它的状态、行为以及遇到的问题。在Java开发中,良好的日志管理不仅能帮助...
- OS X 效率启动器 Alfred 详解与使用技巧
-
问:为什么要在Mac上使用效率启动器类应用?答:在非特殊专业用户的环境下,(每天)用户一般可以在系统中进行上百次操作,可以是点击,也可以是拖拽,但这些只是过程,而我们的真正目的是想获得结果,也就是...
- Java中 高级的异常处理(java中异常处理的两种方式)
-
介绍异常处理是软件开发的一个关键方面,尤其是在Java中,这种语言以其稳健性和平台独立性而闻名。正确的异常处理不仅可以防止应用程序崩溃,还有助于调试并向用户提供有意义的反馈。...
- 【性能调优】全方位教你定位慢SQL,方法介绍下!
-
1.使用数据库自带工具...
- 全面了解mysql锁机制(InnoDB)与问题排查
-
MySQL/InnoDB的加锁,一直是一个常见的话题。例如,数据库如果有高并发请求,如何保证数据完整性?产生死锁问题如何排查并解决?下面是不同锁等级的区别表级锁:开销小,加锁快;不会出现死锁;锁定粒度...
- 看懂这篇文章,你就懂了数据库死锁产生的场景和解决方法
-
一、什么是死锁加锁(Locking)是数据库在并发访问时保证数据一致性和完整性的主要机制。任何事务都需要获得相应对象上的锁才能访问数据,读取数据的事务通常只需要获得读锁(共享锁),修改数据的事务需要获...
- 一周热门
- 最近发表
- 标签列表
-
- mydisktest_v298 (34)
- document.appendchild (35)
- 头像打包下载 (61)
- acmecadconverter_8.52绿色版 (39)
- word文档批量处理大师破解版 (36)
- server2016安装密钥 (33)
- mysql 昨天的日期 (37)
- parsevideo (33)
- 个人网站源码 (37)
- centos7.4下载 (33)
- mysql 查询今天的数据 (34)
- intouch2014r2sp1永久授权 (36)
- 先锋影音源资2019 (35)
- jdk1.8.0_191下载 (33)
- axure9注册码 (33)
- pts/1 (33)
- spire.pdf 破解版 (35)
- shiro jwt (35)
- sklearn中文手册pdf (35)
- itextsharp使用手册 (33)
- 凯立德2012夏季版懒人包 (34)
- 反恐24小时电话铃声 (33)
- 冒险岛代码查询器 (34)
- 128*128png图片 (34)
- jdk1.8.0_131下载 (34)