新来的同事,经常写一些 “烂代码” 偷袭我,这次给领导建议,搞一个代码检查工具,一键扫描,统一风格化编码,看以后还敢乱写代码。

SonarLint(Sonar) 代码质量管理

Sonar是一个用于代码质量管理的开源平台,用于管理源代码的质量 通过插件形式,可以支持包括java,C#,C/C++,PL/SQL,Cobol,JavaScrip,Groovy等等二十几种编程语言的代码质量管理与检测

Sonar可以从以下七个维度检测代码质量,而作为开发人员至少需要处理前5种代码质量问题

1、不遵循代码标准​ sonar可以通过PMD,CheckStyle,Findbugs等等代码规则检测工具规范代码编写

2、潜在的缺陷​ sonar可以通过PMD,CheckStyle,Findbugs等等代码规则检测工具检测出潜在的缺陷

3、糟糕的复杂度分布​ 文件、类、方法等,如果复杂度过高将难以改变,这会使得开发人员难以理解它们 且如果没有自动化的单元测试,对于程序中的任何组件的改变都将可能导致需要全面的回归测试

4、重复​ 显然程序中包含大量复制粘贴的代码是质量低下的,sonar可以展示源码中重复严重的地方

5、注释不足或者过多​ 没有注释将使代码可读性变差,特别是当不可避免地出现人员变动时,程序的可读性将大幅下降 而过多的注释又会使得开发人员将精力过多地花费在阅读注释上,亦违背初衷

6、缺乏单元测试​ sonar可以很方便地统计并展示单元测试覆盖率

7、糟糕的设计​ 通过sonar可以找出循环,展示包与包、类与类之间相互依赖关系,可以检测自定义的架构规则 通过sonar可以管理第三方的jar包,可以利用LCOM4检测单个任务规则的应用情况, 检测耦合。

1. SonarLint

SonarLint是一个代码质量检测插件,可以帮助我们检测出代码中的​坏味道

代码质量提升的 IDEA 插件_maven

下载与安装

代码质量提升的 IDEA 插件_maven_02

在需要检测的单个文件或者单个项目上右键 --> Analyze --> Analyze with SonarLint

或者选中文件或目录,点击菜单栏 Analyze --> Analyze with SonarLint

代码质量提升的 IDEA 插件_代码质量_03

我们还可以禁用某些规则

代码质量提升的 IDEA 插件_代码质量_04

如果需要同步自定义的规则时,可以绑定到SonarQube

代码质量提升的 IDEA 插件_代码质量_05代码质量提升的 IDEA 插件_代码质量_06代码质量提升的 IDEA 插件_代码质量_07

查看检测的结果

代码质量提升的 IDEA 插件_自定义_08

对于代码中的警告我们不能视而不见

代码质量提升的 IDEA 插件_自定义_09

有了代码质量检测工具以后,在一定程度上可以保证代码的质量

对于每一个问题,SonarLint都给出了示例,还有相应的解决方案,教我们怎么修改,极大的方便了我们的开发

比如,对于日期类型尽量用LocalDate、LocalTime、LocalDateTime,还有重复代码、潜在的空指针异常、循环嵌套等等问题

有了代码规范与质量检测工具以后,很多东西就可以​量化​ 了,比如bug率、代码重复率等,还可以自定义各种指标,方便管理人员查看

为此,我们需要一个平台来记录每次检测分析的结果,这样就可以进行分析和统计,并且可以直观的看到这一切

于是,​SonarQube​ 闪亮登场!

2. SonarQube

SonarQube是一个开源的代码质量管理平台

代码质量提升的 IDEA 插件_maven_10代码质量提升的 IDEA 插件_maven_11代码质量提升的 IDEA 插件_自定义_12代码质量提升的 IDEA 插件_maven_13

解压&本地启动

​​

unzip sonarqube-7.7.zip
cd sonarqube-7.7
bin/[OS]/sonar.sh consol

代码质量提升的 IDEA 插件_自定义_14

启动成功后,访问 http://localhost:9000 用管理员账号(admin/admin)登录

代码质量提升的 IDEA 插件_自定义_15

接下来,为了把检测的结果传到服务器,我们需要配置一个Scanner

​​

这里我在项目中添加 sonar-maven-plugin 插件

<build>
<plugins>
<plugin>
<groupId>org.sonarsource.scanner.maven</groupId>
<artifactId>sonar-maven-plugin</artifactId>
<version>3.6.0.1398</version>
</plugin>
</plugins>
</build>

命令行执行:mvn clean compile ​sonar:sonar

成功后,可以在控制台中看到这样的输出

代码质量提升的 IDEA 插件_代码质量_16

再次刷新 http://localhost:9000/ 会看到跟刚才不一样了

代码质量提升的 IDEA 插件_maven_17代码质量提升的 IDEA 插件_自定义_18代码质量提升的 IDEA 插件_代码质量_19

以上只是本地演示,在正式环境中这些数据当然要保存到数据库中,具体安装就不演示了,下面是文档

​​

3. Alibaba代码规约插件

阿里代码规范,相信大家都不陌生

代码质量提升的 IDEA 插件_自定义_20代码质量提升的 IDEA 插件_maven_21代码质量提升的 IDEA 插件_maven_22