【工利其器】必会工具之（七）CheckStyle篇——定制属于你的Java编码规范

前言

如今，代码规范几乎是当下稍有追求的团队都要求做到的，但是对于Java编码规范，不同的公司或团队却有着不同的标准。尽管官方提供了一些标准，但是在基本规则的基础上，各大公司又有自己的规范，比如Sun，Google，华为，阿里等都推出了自己的规范标准，所以对规范进行定制，是常有的需求。而CheckStyle就是这样一款优秀的代码规范审查工具，它允许用户自定义审查标准，而无需人工审查，也无需受限于某一套规则。CheckStyle提供了命令行和插件两种使用方方式，本文将结合Android Studio导入插件的使用方式，来介绍它，希望大家能够好好享受这款插件。

一、CheckStyle简介

Checkstyle是一个开发工具，可以帮助程序员编写遵循编码标准的Java代码。它自动化了检查Java代码的过程，以避免人类完成这一枯燥（但很重要）的任务。这使得它非常适合那些希望实施编码标准的项目。Checkstyle是高度可配置的，可以支持几乎任何编码标准，默认内置Sun Java编码规范和Google Java编码规范两套配置文件，我们也可以根据自己的需要配置自己的规范。

二、CheckStyle的检查项

CheckStyle对Java编码规范的检查项主要包括了如下14项：

（1）Annotations：注解。比如deprecad、override、Suppress Warnings等注解符号以及注解风格使用等。

（2）Block Checks：代码块检测。比如代码块嵌套、空代码块等代码块问题。

（3）Class Design：类设计。比如类的修饰符，设计扩展性，构造函数等相关的问题。

（4）Coding编码问题：代码中出现的漏洞，性能，冗余等代码相关的问题。

（5）Headers：头文件。

（6）Imports：包的导入问题。比如标准中要求避免使用统配导入、避免静态导入、导入顺序，非法导入等。

（7）Javadoc Comments：文档注释。包、类、方法等的归档注释问题。

（8）Metrics：度量。比如布尔表达式复杂度、循环复杂度等各种复杂度问题。

（9）Miscellaneous：杂项。比如代码缩进，一些有用的但非必须的System.out和printstackTrace等问题。

（10）Modifiers：修饰符。比如修饰符是否用对，是否多余，修饰符顺序等。

（11）Naming Conventions：命名约定。包、类、方法、变量等的命令问题。

（12）Regexp：正则表达式。

（13）Size Violations：尺寸超标。比如匿名内部类长度，文件长度，代码每一行长度，方法数量，等超过规范。

（14）Whitespace：空格。在规范中，要求某些操作符，指定标记等周围需要有空格。

参考：https://www.cdsy.xyz/computer/soft/develop/230206/cd40264.html，

三、CheckStyle的安装

与其它的插件一样，CheckStyle插件也提供了直接在AS的仓库中安装和手动离线安装两种方式。

1、直接从AS的插件库下载安装

至于如何在AS插件库中安装插件，在我的另外一篇介绍FindBugs的文章【https://www.cdsy.xyz/computer/soft/develop/230206/cd40254.html】中已经介绍过了，这里就不赘述了。简单说一下就是File > Settings > Plugins > Browse repositories 搜索 “CheckStyle”，找到“CheckStyle-IDEA”这一项，按照提示进行安装，然后重启即可。笔者采用这种方式安装时，提示了好几次网络异常，资源无响应等现象，不过多尝试几次就好了。

2、手动下载并从磁盘安装

请从如下地址获取离线安装包：

链接：

提取码：

四、使用CheckStyle进行分析

1、启动CheckStyle

（1）在AS的左下角有个“CheckStyle”按钮，从这里可以打开CheckStyle面板，从中启动扫描功能。该面板各项功能在下文会详细介绍。

（2）在Java文件的编辑界面点击右键，在弹出的菜单中找到“Check Current File”，点击即可开始扫描。默认是检测当前文件，在控制面板中可以选择检测范围。

2、检查结果

检查完后会显示如下CheckStyle面板，会展示检查出来的各项问题点。该面板各个区域的功能，后面再详细介绍。

通过点击检查结果列表区域，可以定位到问题代码源码处。

五、CheckStyle面板介绍

1、工具栏

（1）Close CheckStyle Window：关闭CheckStyle面板窗口

（2）Stop the running scan：停止当前正在运行的扫描

（3）Check Current File：在编辑器中当前文件上运行CheckStyle

（4） Check Module：在当前Module上运行CheckStyle

（5）Check Project：在当前项目上运行CheckStyle

（6）Check All Modified Files：检查所有修改的文件，结合版本控制工具一起使用。

（7）Check Files in the Current Change List：检查当前change list中的文件

（8）Reload Rules files：清理规则文件（即配置文件）缓存和黑名单，强制重新加载改变后的规则文件。

（9）Autoscroll to Source：自动滚动到错误和警告的源码位置处。

（10）Expand All：展开所有工具窗口（即控制面板）的元素

（11）Collapse All：收起所有工具窗口的元素

（12）Display Errors：展示错误，结果窗口会显示

（13）Dispaly Warnings：展示警告

（14）Display Information Results：展示信息结果

对照说明和每一项的运行结果，各个功能项的作用就很容易理解了。

2、选择检查规则

②处需要事先选择好扫描所采用的代码规范配置文件，默认是没有选择的。

默认这里只有“Sun Checks”和“Google Checks”，“Huawei_CheckStyle”是华为的规范配置，“songwei-style”是自己配置的规范。选择其中某项后，才能以该项对应的配置文件来进行检查。如何添加/删除配置文件，后文会再讲到。

3、检查结果列表

③处显示检查后的结果，以树状结果展示。点击具体某一项后，可以直接跳到问题代码处。

六、配置CheckStyle

File > Settings > Checkstyle就可进入到如下配置界面。

这里我们介绍部分区域功能，其它部分比较简单，就不多说了。

1、扫描范围

选择扫描范围，每一项含义比较简单，就不多介绍了。

2、管理配置文件（这一项很重要）

这里面默认的只有“Sun Checks”和“Google Checks”，后面有“bundled”标识，标识是捆绑在CheckStyle插件中的。要采用哪套规则作为规范标准，需要选中该项。左边的按钮就是添加新的配置文件或者对选中的配置项删除或者编辑。这里着重介绍一下添加新配置项，点击“+”按钮弹出如下对话框：

配置好后，按照向导操作即可。

七、定制配置文件

由于Sun和Google的检查过于严格，所以一般我们需要自己配置或者使用国内业界比较知名的成熟配置方案，比如华为的配置文件。如果我们要完全自己定制的话，可以参照Sun、Google、华为等的模板进行修改。这里提供这三种配置文件的路径：

（1）华为配置文件

链接：https://pan.baidu.com/s/1tlvHtezgjwRIUA8DBVYFUQ

提取码：qxji

（2）Sun Check配置文件

https://github.com/checkstyle/checkstyle/blob/master/src/main/resources/sun_checks.xml

（3）Google Check配置文件

https://github.com/checkstyle/checkstyle/blob/master/src/main/resources/google_checks.xml

这些文件都是以 <module>...</module>对的形式组成的，这每一对就表示了一条匹配的规则。如下就是一条对“JavadocType”的匹配规则，如果不需要检查这一项，可以直接注释掉，或者根据需要做其它修改。

1 <module name="JavadocType">
2     <property name="authorFormat" value="\S"/>
3     <property name="scope" value="protected"/>
4     <property name="tokens" value="CLASS_DEF,INTERFACE_DEF"/>
5 </module>

如果需要了解每一个属性的作用等更深入的知识，可以查看CheckStyle官网：https://checkstyle.org/index.html进行学习，这里就不深入介绍了。

结语

本文只介绍了CheckStyle常见的一些使用方法，一定还有很多很牛的功能，希望读者们多多探索，多多交流，共同进步，谢谢！