一 . SonarQube 代码质量检查工具简介
Sonar (SonarQube)是一个开源平台，用于管理源代码的质量
Sonar 不只是一个质量数据报告工具，更是代码质量管理平台
支持 Java, C#, C/C++, PL/SQL, Cobol, JavaScrip, Groovy 等等二十几种编程语言的代码质量管理与检测。
Sonar 可以从以下七个维度检测代码质量，而作为开发人员至少需要处理前 5 种代码质量问题。
- 不遵循代码标准
- sonar 可以通过 PMD,CheckStyle,Findbugs 等等代码规则检测工具规范代码编写。
- 潜在的缺陷
sonar 可以通过 PMD,CheckStyle,Findbugs 等等代码规则检测工具检 测出潜在的缺陷。
- 糟糕的复杂度分布
文件、类、方法等，如果复杂度过高将难以改变，这会使得开发人员 难以理解它们, 且如果没有自动化的单元测试，对于程
序中的任何组件的改变都将可能导致需要全面的回归测试。
- 重复
显然程序中包含大量复制粘贴的代码是质量低下的，sonar 可以展示 源码中重复严重的地方。
- 注释不足或者过多
没有注释将使代码可读性变差，特别是当不可避免地出现人员变动 时，程序的可读性将大幅下降 而过多的注释又会使得开发人员将精力过多地花费在阅读注释上，亦违背初衷。
- 缺乏单元测试
sonar 可以很方便地统计并展示单元测试覆盖率。
- 糟糕的设计
通过 sonar 可以找出循环，展示包与包、类与类之间的相互依赖关系，可以检测自定义的架构规则 通过 sonar 可以管理第三方
的 jar 包，可以利用 LCOM4 检测单个任务规则的应用情况，检测藕合。
为什么要选择 sonarQube?
个人使用之后认为 : sonarQube 的优势如下(相比于阿里编码规约这种市面上常见类似软件):
- 更加优秀的图形化界面
基本上通过界面就可以对自己项目的代码状况一目了然
- 可以查询出其它软件难以定位到的问题
比如 :
可能导致空指针异常的问题 (对象在进行使用前没有加空的判断)
可能导致内存泄漏的问题, 在 try catch 块里面, 直接使用 e.printStackTrace()将堆栈信息打印到内存的
可能导致的漏洞 : 成员变量使用 public 定义的
还有诸如 : 流等未关闭或者是非正常关闭都能够检测出来!
功能非常强大!!
二. 安装：
2.1 安装 SonarQube web server
- 首先确保安装了 jdk1.8 +
- 到此链接 https://www.sonarqube.org/dow…
下载 sonalqube(下载社区版, 是开源的),
我下载的是 sonarqube-7.2.1，因为最新版 7.9.1 需要 jdk11 支持
并解压, 解压完之后的目录如下 :
- 到解压目录的 binmacosx-universal-64(对应系统)目录下:
linux、Mac
sh sonar.sh start启动windows 双击
StartSonar.bat启动 - 到浏览器界面, 输入 : http://localhost:9000
如果能访问表明安装成功
2.2 安装数据库
-
版本要求:
在 conf 目录下的 sonar.properties 文件下:
有这样一行配置 :
#----- MySQL >=5.6 && < 8.0 -
为 sonarqube 创建一个数据库
create database sonar; -- 创建数据库 -
创建 sonarqube 用户并进行授权
CREATE USER 'username'@'host' IDENTIFIED BY 'password'; -- 创建用户并设置密码 -- username 为创建的用户名 -- host 为对应的主机地址, 本地就是 localhost -- password 为设置的密码 GRANT ALL ON *.* TO 'username'@'localhost'; -- 对用户进行授权操作 -
修改 SonarQube 配置文件, 添加 Mysql 相关配置
sonar.jdbc.url=jdbc:mysql://localhost:3306/sonar?useUnicode=true&characterEncoding=utf8&rewriteBatchedStatements=true&useConfigs=maxPerformance&useSSL=false # 刚刚创建的 sonarQube 用户 sonar.jdbc.username=sonar # 创建用户对应的密码 sonar.jdbc.password=sonar # 设置编码格式为 UTF-8 sonar.sorceEncoding=UTF-8 # sonar 登陆用户名 sonar.login=admin # sonar 登陆密码 sonar.password=admin
2.3 重新启动服务端
- 退出 SonarQube 服务端
在之前弹出的 cmd 窗口执行 ctrl + c,
弹出来的提示选择 Y, 退出 SonarQube 服务
- 双击 StartSonar.bat 文件, 重新启动 SonarQube
这次因为要进行数据库的初始化操作, 所以需要的时间可能稍微久一点
- 启动成功后, 浏览器输入 : http://localhost:9000 进入界面
-
登录
点击界面右上角的登录按钮, 进行登录 :
初始的账户名 : admin
初始的密码 : admin
附 : 一些关键配置的修改, 如 主机地址,context, 端口号等:
通常情况下使用默认的配置即可!
文件 /conf/sonar.properties
#sonar.web.host=0.0.0.0 #sonar.web.context= #sonar.web.port=9000
三. 使用
3.1. 安装必要的插件 (汉化包举例)
点击 导航栏的 Administration, 选择 Marketplace
搜索 Chinese pack, 点击 install 进行安装
安装成功后, 重启 SonarQube !
3.2. 开始分析项目代码源代码
使用 maven 的方式进行分析
3.2.1 编辑 maven 的 settings.xml 文件
<settings>
<pluginGroups>
<pluginGroup>org.sonarsource.scanner.maven</pluginGroup>
</pluginGroups>
<profiles>
<profile>
<id>sonar</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<sonar.host.url>http://loaclhost:9000</sonar.host.url>
</properties>
</profile>
</profiles>
</settings>其中 sonar.host.url 值就是 上文启动的 sonar 服务器地址。
3.2.2 对 maven 项目进行分析
到项目所在的文件路径下:
使用命令提示符或者是 power shell 执行 如下命令:
mvn org.sonarsource.scanner.maven:sonar-maven-plugin:3.6.0.1398:sonar出现: BUILD SUCCESS 标识之后
刷新界面查看 :
3.3 配置分析参数
强制参数：
-
Server
sonar.host.url http://localhost:9000 -
Project Configuration
sonar.projectKey Maven <groupId>:<artifactId>sonar.sources Maven 默认的源码路径
可以配置的参数：
-
Project identity
sonar.projectName 项目名称sonar.projectversion 项目版本
-
Authentication
sonar.login 分析该项目的用户名称sonar.password 分析该项目的用户密码
3.4. 程序员用户使用说明
SonarQube Web 管理者通过配置和设置以下参数值对项目源代码进行：
复杂度、覆盖率、文档、重复、问题、可维护性、可靠性、安全性、大小等约束和规范。
sonar 中的质量阈管理以下内容。
复杂度
复杂度
复杂度 / 类
复杂度 / 文件
复杂度 / 方法
覆盖率
分支覆盖
集成测试的新分支覆盖
新代码的分支覆盖率
覆盖率
新集成测试覆盖
新覆盖率
集成测试分支覆盖
集成测试覆盖
集成测试覆盖行
集成测试未覆盖分支
集成测试未覆盖行
代码覆盖率
集成测试的新行覆盖
新代码覆盖率
代码行
集成测试的新行覆盖
覆盖的新代码
总体分支覆盖率
总体新分支覆盖率
总体覆盖率
总体新覆盖率
总体代码覆盖率
总体新代码覆盖率
总体覆盖的新行数
总体未覆盖分支
总体未覆盖的新分支
总体未覆盖代码
总体未覆盖新行数
单元测试忽略数
未覆盖分支
集成测试未覆盖的新分支
未覆盖新分支
未覆盖的代码
集成测试未覆盖的行
未覆盖的新代码
单元测试持续时间
单元测试错误数
单元测试失败数
单元测试成功 (%)
单元测试数
文档
注释行
注释 (%)
公共 API
公共注释的 API (%)
公共未注释的 API
重复
重复块
重复文件
重复行
重复行(%)
问题
阻断违规
确认问题
严重违规
误判问题
提示违规
违规
主要违规
次要违规
新阻断违规
新严重违规
新提示违规
新违规
新主要违规
新次要违规
开启问题
重开问题
不修复的问题
可维护性
新代码的技术债务
坏味道
达到可维护性 A 级所需的工作
新增坏味道
技术债务
技术债务比率
新代码技术债务比率
Management
Burned budget
Business value
Team size
可靠性
Bugs
新增 Bugs
可靠性修复工作
新代码的可靠性修复工作
安全性
新增漏洞
安全修复工作
新代码的安全修复工作
漏洞
大小
类
目录
文件
方法
生成的行数
生成的代码行数
行数
代码行数
项目
语句