Code Review防毒打指南

简介: Code Review防毒打指南

命名规范

取名过于简单,无法清晰表达含义。

可能在自己编写代码的时候可以理解,但是别人第一眼看到这样的命名时,是完全不知道它具体表达了什么含义的,很难阅读

// 单字符,剪短单词作为变量名
 let flag = false;
 for(f in markedFiles){
   //handler each marked file
 }

命名风格不一,影响代码阅读

他们都是判断性函数的命名,但是使用不同命名风格

我们应该尽量养成一个固定命名思路或者命名风格

//多种风格的方法名
 isProcessRunning()
 checkIfPageClosed()

建议

  1. 可以适当参照现有代码的命名风格。
  2. 命名要能够清晰展现有关的含义(好的命名的基本要求)
    -较长清晰的命名优于简短模糊的命名,不要过于追求简短
    -一个命名花费的思考是值得的。
  3. 命名技巧学习:
    -多阅读书籍、教程、知名源码等等,学习命名思路和技巧。

注释不合规

修改代码不更新注释,造成误导

//do something about A 
 Function()
 {
     // do some actions about B
 }

无意义的注释(如日志型注释,废弃的代码)

这类注释对于代码逻辑没有任何的理解上的帮助,相反还增加了篇幅,随着现代项目管理工具越来越强大已经不需要了。

/*
  * Date: 1 Jan
  * Author: Hy
  * Change: Update this function for fixing bug : ...
  * ........
 */
 Function(){
     /*
     OldFlow();
     */
     NewFlow();
 }

过多篇幅的注释

别人不一定有耐心去读我们的注释,如果代码不够清晰,注释再多,也不利于后期的修改和维护。

所以过多篇幅的注释出现在了我们代码中,我们要考虑是不是可以让代码更清晰

/*
     multi-lines
 */
 Function(){
     ......
 }

建议:

  1. 避免写出坏注释
    -不达意的注释
    -含有误导的注释
    -与逻辑无关的注释
  2. 及时更新注释
  3. 清晰代码不需要太多注释说明的

函数封装和复用

不使用团队封装的工具库,自己重新实现

公司封装这些工具库、组件的目的是让所有人使用或调用的时候可以在同一个规范上使用同样的代码,便于后续问题的排查,保证我们代码的质量。

自己重新实现容易带来一些阅读、后期维护等问题。

函数过长,缺乏提炼

Function()
 {
     // do A
     ...
     // do B
     ...
     // do C
     ...
     ...
 }

三次及以上重复代码不做复用

重复两次时可做可不做,一旦到达三次一定封装

修改公共库时只考虑到自身业务逻辑

只顾及自己的业务实现,不兼容他人使用场景

建议:

  1. 使用组件时,先看看是否团队进行过封装
  2. 按照职责设计和提炼函数,尽量做到函数单一职责
  3. 相同逻辑的代码积极复用

不合理的变量定义

变量定义不考虑解耦

例子中,此种域名如果我们定义多个,就没有做到解耦以及复用

//方法体中的整型/字符串定义
 let loginUrl = "www.xxx.com/login"
 let helpUrl = "www.xxx.com/help"

根据使用场景判断是否应该动态生成内容

const systemPath = "C:\";

例如Windows的操作系统一般是C盘,但这个可以手动更改

如果代码中我们设置为C盘,那后续如果用户本身系统盘并不是C盘,那就会出问题,应通过API或其他方式进行获取、



目录
相关文章
|
JavaScript 前端开发 安全
15个最佳的代码评审(Code Review)工具
  代码评审可以被看作是计算机源代码的测试,它的目的是查找和修复引入到开发阶段的应用程序的错误,提高软件的整体素质和开发者的技能。代码审查程序以各种形式,如结对编程,代码抽查等。在这个列表中,我们编制了15个最好的代码审查工具,这将有助于开发者节省代码审查时间。
4624 0
|
4月前
|
安全 Java 测试技术
code review 正确方式
code review 正确方式
85 1
|
7月前
|
Java 测试技术 p3c
我们如何做Code Review
我们如何做Code Review
131 0
|
敏捷开发 开发者
Code Review 全面审查清单
Code Review 全面审查清单
672 0
Code Review 全面审查清单
|
监控 算法 程序员
大厂怎么做Code Review?
发现坏味道的实践,就是Code Review:对计算机源代码系统化地审查,常用软件同行评审的方式进行,其目的是在找出及修正在软件开发初期未发现的错误,提升软件质量及开发者的技术
315 0
|
开发框架 安全 IDE
|
测试技术 Java 开发工具
|
设计模式 测试技术 程序员
7 个建议让 Code Review 高效又高质
Code Review(CR) 的本质是什么?是为了查错?还是为了 KPI?本文分享阿里资深技术专家的看法:CR 是一种关于社会学的长期行为和组织文化,通过 CR,形成一种良性互动的技术氛围,传播和分享知识,提升代码质量,并给出了 7 个提高 CR 效率和质量的实践建议。
4399 0
7 个建议让 Code Review 高效又高质
聊Code review(下)
上篇描述了什么是code review, 为什么要去做,主要包含哪些内容。本文主要讲如何去做Code review?会带来什么惊喜? 本文的分享者易荣平认为思路比方法重要,Code review 是为了推广代码的最佳实践,而不是挑出代码存在的问题。猿猿们精彩不容错过。
4532 0
8 个 Tips 让你更好的进行 Code Review
Code Review 可以提高代码质量。
1312 0