阿里巴巴早在2017年就推出了《Java开发手册》,旨在规范Java开发人员在开发过程中的编码,这套Java统一规范标准将有助于提高行业编码规范化水平,帮助行业人员提高开发质量和效率、大大降低代码维护成本。
为了让开发者更加方便、快速的将规范推动并实行起来,阿里巴巴基于手册内容,研发了一套自动化的IDE检测插件, 该插件在扫描代码后,将不符合手册规范的代码显示在界面中。我们可以在IDEA中选择 Preferences - Plugins - Browse repositories ,输入框中输入"alibaba",选择"Alibaba Java Coding Guidelines"进行安装,重启IDEA后即可使用。
Google也在2016年推出了《Java编程规范》,它是Google公司对Java编程风格规范的完整定义,主要内容包含编码格式是否美观的问题, 同时也讨论一些约定及编码标准。国内已经有人将其翻译为中文,具体请参考 Google《Java编程规范》中文版 ,另外如果需要PDF文档可以在 这里 去下载 。另外在Eclipse IDE和 IntelliJ IDE可以导入代码风格配置文件,可以方便使用该编码规范,请点击 传送门,具体方法是依次点击 Window -> Preferences -> Java -> Code Style -> Formatter -> Import,导入下载文件后即可使用。
本系列文章将结合两个《Java规范》进行总结,通过具体编码案例给出编码规范的原因,如果总结内容存在问题还望指出。
目录
本篇文章内容承接上一篇文章《Java开发规范之命名篇(上)》,进一步介绍Java开发的命名规范,主要针对阿里巴巴规范条目,同时结合Google规范。由于阿里巴巴规范比较详细,文章内容顺序以该规范为准。
11.缩写
【Alibaba 】杜绝完全不规范的缩写,避免望文不知义。
【Google】比起其它类型的名称,局部变量名可以有更为宽松的缩写。虽然缩写更宽松,但还是要避免用单字符进行命名,除了临时变量和循环变量。
说明:不正确的缩写会误导理解代码功