IntelliJ IDEA 插件 阿里巴巴Java开发手册(Alibaba Java Coding Guidelines)

以前看到过个:Java开发手册(阿里巴巴-公开版),这是个pdf文档,里面描述了一些Java开发的规约,里面确实有很多好用的规约,要是在学校就有机会看看的话,那么,在毕业之后,实际工作中就会少很多坑。现在,阿里巴巴又一次对这个文档进行了升级,直接变成了一个插件。你需要的就是:知道有这么个插件,然后,还得安装这个插件,那么以后,你在写代码的时候,这个插件就会自动的纠正你在写代码的时候的一些很low的不规范代码。

下面看怎么在这个 IntelliJ IDEA 上安装这个插件。

通过Jetbrains官方仓库安装

1. 打开 Settings >> Plugins >> Browse repositories...

2. 在搜索框输入alibaba即可看到Alibaba Java Code Guidelines插件,点击Install进行安装,然后重启IDE生效

注意:因为插件zip包托管在Jetbrains官方CDN上,所以是从国外的服务器进行下载,可能会出现超时的情况

也就是说,你下载半天,他就是没下载下来。

表紧,下面还有离线安装的呢。我提供云盘链接。

通过离线的安装包安装

看云盘地址。

链接:http://pan.baidu.com/s/1c2fbTmC 密码:f9lu

安装完插件,一般都是需要重启一下IDE的。重启完之后,这个插件就可以工作啦。

可能会有中文乱码以及中英文提示切换

这个中文乱码说的估计是,这个插件的提示有些是中文的(下面看自定义显示提示的,就可以看到很多的提示是中文的),因为,这个编辑器 不是老外写的吗。所以,他自带的提示,都是英文的,所以,阿里写的插件,自带的提示就是中文的,这个提示的中文,可能是乱码,但是也不一定。因为,我安装这个编辑器的时候,好像默认字体就是微软雅黑(microsoft yahei light)

可以看下,新出来的2个按钮

可以看到这个地方,不是可以切换语言至英文吗?,切换之后,要重启的。

不过,看我博客的,估计都是使用汉字的,那咱就不换了 ,就用这个中文提示吧。

具体使用

这个不是多了2个按钮吗?

上面的tool bar的后面多了2个按钮,如下图,这2个按钮,还可以直接在当前文件内,右键,也是可以看到选项的。这是对单个文件操作。

也可以,在左侧的Project目录树种点击右键,可以触发对整个工程或者选择的某个目录、文件进行检测。

一个按钮,绿色的那个“编码规约扫描”,点击之后,就会对当前文件进行分析。

后面那个蓝色的按钮,他就是打开和关闭,实时检测。

实时检测功能会在开发过程中对当前文件进行检测,并以高亮的形式提示出来,同时也可以支持 Quick Fix,该功能默认开启,可以通过配置关闭。

我在上面这个截图里面,截取了这个按钮,也就是蓝色的那个,2种情况下的状态。至于,这个 Quick Fix ,我马上给你说,这个知道的,就不需要解释啦,不知道的,就听湿胸我啰嗦一下吧。

下面是一张,实际分析一个Java文件代码的截图。

这个图,就是你在当前编辑的文件,直接点右上角的那个绿色按钮““编码规约扫描””,或者,你右键,再选择“编码规约扫描”也可以。

然后,就出现了上图的分析结果。

可以简单的看一下。

我图上打圈的这个,刚刚工作的小伙伴,可能就会出这个问题,具体原因,上面也给出了描述。

1,有可能会空指针异常,正确的写法,就是常量在前面,调用这个equals方法。

2,方法名、参数名、成员变量、局部变量都统一使用lowerCamelCase,必须遵从驼峰形式(这个也是刚刚工作的小伙伴不在意的问题)

3,不允许任何魔法值(即未经定义的常量)直接出现在代码中。上面那个使用equals方法的这个字符串,是直接写在代码里面的,这个就叫做 “ 魔法值 ”。

4,及时清理不再使用的代码段或配置信息。当你在改别人代码的时候,直接把不用的就删除了吧,别想着说,需求搞不好还会改回来呢。不然满屏幕都是注释的但是未删除的代码,最后,注释的代码比正儿八经工作的代码还多。

5,关于代码注释的正确书写姿势啦。这就不多说了。

关于Quick Fix 的使用(高科技,简单实用。)

这个一般都是在你写完代码,发现代码那地方有提示,看下图,就知道啦。

就是左边的那个灯泡状的东西,一般你鼠标光标移动到代码下面有横线的地方,他就会提示你怎么去修改。

这样,你可以快捷的修改代码,比如,上面这个常量字符串应该在前面,这个时候,你只需要按2下下方向,选我截图所指的那个地方,回车之后,他就把你的代码给自动修正啦,这就大大加快了代码 编辑速度。

这地方,有个快捷键,不知道这快捷键的,估计你就得用鼠标点点点啦,这太慢啦。

我这windows系统,哦,我的idea使用的keymap是eclipse,所以,我这个对应的快捷键就是 alt + enter。。。快捷键一按,然后,啪啪啪,按几下方向键,就可以直接修改代码啦。

好多代码提示的地方,都可以,这么试试,看看效果。

随心所欲的使用此插件的提示功能

理论上讲,老师给你讲的东西,那都是为你好,但是,做为学生的我们,并不希望,事事都听老师啰嗦。也有一些事儿,这指的是这个插件的提示咯。并不是很必要的,我们不想看到这些提示,怎么办呢?这个是可以自定义的。

先看一个不是很必要的提示的截图吧。

我这都写了 create by 啦后面也写日期啦,但是,此插件还是提示我说没写作者,下面看这个提示的点开详情图。

等下,可能有些老铁,不知道在哪设置这个名字吧,这地方的默认值是自己电脑的名字,而不一定是你想要的名字。看下面链接,怎么自己设置。

IntelliJ IDEA 中怎么修改新建文件时,自动生成的注释的user的默认值

好,那下面就看怎么把这个不需要的提示给关掉

关掉之后,就不会有这个提示啦。看下图,就是关掉之后的效果。

关掉分析结果的窗体

我使用的idea的版本是2017.1 ,开发版,也即是需要注册激活的idea。不是社区版哦,社区版很多功能都不能用。jdk 1.7  1.8 都有。

实际检测之后的提示实例

下面放几个这个插件的实际检测之后,提示效果图。

关于注释的正确姿势的提示。

关于有人写if语句不带括号的提示。

关于变量命名不按驼峰法套路的提示。

long类型的数据,后面要用大些的L,这个主要是让人看的舒服,机器是无所谓的。

枚举都有写注释,不能因为太简单,就不写注释。

还是变量的命名,需要注意的地方。

转自:http://blog.csdn.net/qq_27093465/article/details/78338932

原文地址:https://www.cnblogs.com/SimonHu1993/p/8462729.html

时间: 2024-10-02 18:05:50

IntelliJ IDEA 插件 阿里巴巴Java开发手册(Alibaba Java Coding Guidelines)的相关文章

阿里巴巴Java开发手册1.4.0

转自官网 前言 <阿里巴巴Java开发手册>是阿里巴巴集团技术团队的集体智慧结晶和经验总结,经历了多次大规模一线实战的检验及不断完善,系统化地整理成册,回馈给广大开发者.现代软件行业的高速发展对开发者的综合素质要求越来越高,因为不仅是编程知识点,其它维度的知识点也会影响到软件的最终交付质量.比如:数据库的表结构和索引设计缺陷可能带来软件上的架构缺陷或性能风险:工程结构混乱导致后续维护艰难:没有鉴权的漏洞代码易被黑客攻击等等.所以本手册以Java开发者为中心视角,划分为编程规约.异常日志.单元测

阿里巴巴 Java 开发手册评述

2016年底,阿里巴巴公开了其在内部使用的Java编程规范.随后进行了几次版本修订,笔者当时看到的版本为v1.0.2版.下载地址可以在其官方社区--云栖社区找到. 笔者作为一名有数年工作经验的Java程序员,仔细研读了这份手册,觉得是一份不可多得的好材料.正如阿里巴巴在发布时所说,"阿里巴巴集团推出的<阿里巴巴Java开发手册(正式版)>是公司近万名开发同学集体智慧的结晶,以开发视角为中心,详细列举了如何开发更加高效.更加容错.更加有协作性,力求知其然,更知其不然.结合正反例,让Ja

阿里巴巴Java开发手册(华山版)

title: Java开发规范 date: 2018-10-08 14:01:59 tags: Java categories: Java --- 前言 本文章是将网上PDF版本的Java开发规范转换成的Markdown版本 Java 开发手册 版本号 作者 日期 备注 1.4.0 阿里巴巴集团技术团队 2018. 5. 20 增加设计规约(详尽版) 一.编程规约 (一) 命名风格 [强制]代码中的命名均不能以下划线或美元符号开始,也不能以下划线或美元符号 结束. 反例:_name __name

阿里巴巴Java开发手册上常规的编程命名总结

阿里巴巴Java开发手册上常规的编程命名总结:1.类名必须驼峰.例子:MarcoPolo / UserDO / XmlService / TcpUdpDeal / TaPromotion 2.方法名.参数名.成员变量.局部变量都统一使用 lowerCamelCase 风格,必须遵从驼峰形式.例子:localValue / getHttpMessage() / inputUserId 3.常量命名全部大写,单词间用下划线隔开,力求语义表达完整清楚,不要嫌名字长.例子:MAX_STOCK_COUNT

《阿里巴巴 Java开发手册》读后感

前言 只有光头才能变强 前一阵子一直在学Redis,结果在黄金段位被虐了,暂时升不了段位了,每天都拿不到首胜(好烦). 趁着学校校运会,合理地给自己放了一个小长假,然后就回家了.回到家才发现当时618买了一堆书,这堆书还有没撕包装的呢....于是我翻出了最薄的一本<阿里巴巴 Java开发手册> 这本书一共就90多页,一天就可以通读完了,看完之后我又来水博文了. 注意: 书上很多的规范是可以用IDE来避免的,也有很多之前已经知道的了. 所以,这篇文章只记录我认为比较重要,或者说是我之前开发时没有

java开发手册(阿里巴巴)——编程规约(部分)

(一)命名风格 3. [强制]类名使用 UpperCamelCase 风格,但以下情形例外:DO / BO / DTO / VO / AO / PO / UID 等. 正例:MarcoPolo / UserDO / XmlService / TcpUdpDeal / TaPromotion 反例:macroPolo / UserDo / XMLService / TCPUDPDeal / TAPromotion 6. [强制]抽象类命名使用 Abstract 或 Base 开头:异常类命名使用

阿里巴巴 Java 开发手册 1.4.0

一.编程规约(一) 命名风格1. [强制]代码中的命名均不能以下划线或美元符号开始,也不能以下划线或美元符号结束.反例: _name / __name / $name / name_ / name$ / name__2. [强制]代码中的命名严禁使用拼音与英文混合的方式,更不允许直接使用中文的方式.说明:正确的英文拼写和语法可以让阅读者易于理解,避免歧义.注意,即使纯拼音命名方式也要避免采用.正例: alibaba / taobao / youku / hangzhou 等国际通用的名称,可视同

阿里巴巴Java开发手册正确学习姿势是怎样的?刷新代码规范认知

很多人都知道,阿里巴巴在2017发布了<阿里巴巴Java开发手册>,前后推出了很多个版本,并在后续推出了与之配套的IDEA插件和书籍. 相信很多Java开发都或多或少看过这份手册,这份手册有7个章节,覆盖了编程规约.异常日志.单元测试.安全规约.MySQL数据库.工程结构以及设计规约等方面. 这份规约可以说是覆盖了Java开发的方方面面,如果还有人没看的话,强烈建议大家好好看看,并且仔细研读. 手册中,有那么一些规则,是比较容易理解的.比如一些变量命名规范,有另外一些规则,是不太容易理解的,背

阿里巴巴Java开发手册

序号 文档名及下载地址 1 阿里巴巴Java开发手册v1.2.0 其他