Alibaba Java Coding Guidelines，之后的Java代码规范，就靠它了

前言

       对于Java代码规范，业界有统一的标准，很多公司对此都有必定的要求。可是即使如此，庞大的Java使用者因为经验很水平的限制，未必有规范编码的意识，并且即使经验丰富的老Java程序员也没法作到时刻将规范牢记于心。因此对于代码规范扫描工具，一经问世就广受青睐，阿里巴巴出品的Alibaba Java Coding Guidelines（阿里巴巴Java代码规约扫描，如下简称为AJCG）插件即是其中之一。与不少其它流行的同类工具（如FindBugs，Lint等）相比，它更专一于Java代码规范，并且默认采用中文，对于英文没那么好的开发者而言，这无疑是一种福利。本文将结合Android Studio（如下简称AS），介绍一下该插件的使用。

 

1、AJCG简介

       为了让开发者更加方便、而且达到快速规范代码格式的目的并实行起来，阿里巴巴基于《阿里巴巴Java开发规约》手册内容，研发了一套自动化的IDE检测插件，它就是Alibaba Java Coding Guidelines 插件。2017年10月14日杭州云栖大会，AJCG全球首发仪式正式启动，规范正式以插件形式公开走向业界，引领Java语言的规范之路。该插件在扫描代码后，将不符合规约的代码按Blocker/Critical/Major三个等级显示出来，而且大部分能够自动修复。它还基于Inspection机制提供了实时检测功能，编写代码的同时也能快速发现问题所在。

 

2、在AS中安装AJCG插件

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

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

       至于如何在AS插件库中安装插件，在个人另一篇介绍FindBugs的文章【http://www.javashuo.com/article/p-tqxvbbgf-cq.html】中已经介绍过了，这里就不赘述了。简单说一下就是

  File > Settings > Plugins > Browse repositories 搜索 “Alibaba Java Coding Guidelines”，按照提示进行安装，而后重启便可。

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

 

3、使用AJCG

  一、启动AJCG扫描 

       大体能够经过以下两种方式启动AJCG进行扫描（好像还有别的启动方式，我们知道这两种方式就够了）：

    （1）能够Tools > 阿里编码规约 > 编码规约扫描

    （2）在编辑界面或者AS左边的项目区域点击右键，在右键菜单中选择“编码规约扫描”便可。  

       

  二、菜单功能

       第一种启动方式比第二张多一项功能，这三项列表功能以下：

    （1）编码规约扫描：开始扫描代码。

    （2）打开/关闭实时检测功能：实时检测代码，顾名思义，对代码进行实时检测。通常机器性能比较好的话能够开启这项功能，若是已经开启，这里会显示“关闭实时检测功能”。

    （3）切换语言至英文：中英文切换。

  三、执行结果 

       扫描完成后显示结果以下（若是当前鼠标点击的是最终项，右边区域显示的是其它的内容，后面会再讲到）： 

   

  四、指定区域搜索同一类问题

       当点击③处的按钮时，会弹出以下按钮：

 

 这里选择扫描区域，来扫描鼠标选中的同类问题。若是按照默认选择，那么运行后的结果就是：

 这里咱们能够看到，显示了整个Project中的全部该类的问题。

  五、预览具体的不规范代码

       在第3点的执行结果中，若是点击的是最终的问题点或者问题所在的类文件，那显示的就是以下界面，预览该处不规范的代码。

 

 

4、工具栏功能介绍

       工具栏的这些功能常常会用到，这里简单对每个功能简单介绍一下：

  （1）Rerun Inspection： 从新运行一次扫描

  （2）Close：关闭真个AJCG面板

  （3）Expand All：展开结果的树状结构，整个结果是树状结构的。

  （4）Collapse All：收起结果的树状结构

  （5）Go Pre Problem：选择上一个问题

  （6）Go Next Problem：选择下一个问题

  （7）Help：帮助

  （8）Group by Serverity：（不知道如何描述）

  （9）Group by derectory：按目录分组/按类名分组间切换

  （10）Filter resoled items：过滤掉已经解决的项

  （11）Autoscroll to Source：自动滚动到源码

  （12）Export：导出，能够导出为XML和HTML两种格式

  （13）Edit Settings：编辑设置

 

5、扫描结果

       该部分区域显示了执行结果，因为是设置的中文版，因此这里显示的都是中文，这看起来很是爽。

       咱们能够看到Blocker（阻挡者）、Critical（严重问题）、Major（主要的）三个大类，他们表示的是问题的严重程度，严重程度由高到低为：Blocker > Critical > Major。至于每一类中都会包含什么样的问题，图中的中文已经说明了一切，这里就不赘述了。

 

福利

       这提供一份《阿里巴巴Java开发手册（记念版）》电子文档

       连接：https://pan.baidu.com/s/1z2u1ITJGJvgsJqrgq_AYwQ

       提取码：v9ja

 

结语

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