目录

1、配置效果:2、配置方法:

一、类注释

1、显示模板

2、在idea 新建文件设置类注解的两种方式

(1)、new生成-直接设置File Header(description需要自己重新输写)

(2)、new生成-分别设置需要注释的类(description可以在创建的时候直接弹出框输入)

二、方法注释

1、显示模板

2、方法的注释步骤

Step 1 点击“File”-->“Settings”-->“Live Templates”打开如下对话框,点击右边绿色的加号,创建一个自定义的Template Group,命名为MyGroup。如下图所示。

Step 2 选中 MyGroup,点击右边绿色的加号的创建一个自定义的 Live Template,比如class-comment以及method-comment如下图所示。

Step 3 设置注释的内容(注释模板在该模块的最上面)

Step 4 设置模板的变量内容

3、类的自定义注释

三、属性注释

四、特殊注释标记 TODO:

五、代码业务修改:

六、方法内部单行注释

附录一 Edit variables的含义


 

1、配置效果:

idea常用java代码段模板 idea代码规范_自定义

2、配置方法:

 

在自己idea的安装文件下  D:\Users\xxxx\.IdeaIC2018.3\config\templates

复制MyGroup.xml文件粘贴到相应自己对应的目录即可,有问题可以咨询创建者,找个文件直接上传不了,我放在下载资源

 

idea常用java代码段模板 idea代码规范_idea常用java代码段模板_02

 

 

对于注释的要求:第一、能够准确反应设计思想和代码逻辑;第二、能够描述业务含 义,使别的程序员能够迅速了解到代码背后的信息。

 

下面主要将几类注释,配置然后自动产生。

 

一、类注释

1、显示模板

/**

* @author : ${USER}

* @date :${YEAR}/${MONTH}/${DAY} ${HOUR}:${MINUTE}

* @description : ${description}

* @path : ${PACKAGE_NAME}.${NAME}

* @modifiedBy :

*/

说明:

description 描述 : 该方法做什么事情,实现什么功能

 

2、在idea 新建文件设置类注解的两种方式

 

(1)、new生成-直接设置File Header(description需要自己重新输写)

idea常用java代码段模板 idea代码规范_自定义_03

 

(2)、new生成-分别设置需要注释的类(description可以在创建的时候直接弹出框输入)

 

 

idea常用java代码段模板 idea代码规范_自定义_04

 

二、方法注释

 

1、显示模板

 

方法 显示模板

/**

* @author : $USER$

* @date : $date$ $time$

* @description:$description$

$params$

* @return $returns$

* @throws

*/

 

类:显示模板

/**

 * @author : $USER$

 * @date :$data$ $time$

 * @description : $description$

 * @path : $PACKAGE_NAME$.$NAME$

 * @modifiedBy :

 */

 

2、方法的注释步骤

 

Step 1 点击“File”-->“Settings”-->“Live Templates”打开如下对话框,点击右边绿色的加号,创建一个自定义的Template Group,命名为MyGroup。如下图所示。

 

idea常用java代码段模板 idea代码规范_idea常用java代码段模板_05

Step 2 选中 MyGroup,点击右边绿色的加号的创建一个自定义的 Live Template,比如class-comment以及method-comment如下图所示。

 

idea常用java代码段模板 idea代码规范_单行注释_06

Step 3 设置注释的内容(注释模板在该模块的最上面)

 

idea常用java代码段模板 idea代码规范_自定义_07

Abbreviation:通过输入里面内容引用注释

method-comment

class-comment

Description:描述这个做什么

 

Step 4 设置模板的变量内容

idea常用java代码段模板 idea代码规范_ide_08

groovyScript("def result=''; def params=\"${_1}\".replaceAll('[\\\\[|\\\\]|\\\\s]', '').split(',').toList(); for(i = 0; i < params.size(); i++) {result+=' * @param ' + params[i] + ((i < params.size() - 1) ? '\\n\\b' : '')}; return result", methodParameters())

 

注意:这里直接在方法外面加注释,获取不到参数和返回值,因为参数和返回的值只有在函数作用域内,intellij才能找到。

所以快捷键最好还是在方法内部敲,再把注释复制出去。

 

如果想了解更多的Edit Variables的含义可参考

附录一 Edit variables的含义

 

3、类的自定义注释

 

步骤和2 方法的注释类似。

显示模板可参照 1 类:显示模板

idea常用java代码段模板 idea代码规范_ide_09

 

设置变量

idea常用java代码段模板 idea代码规范_ide_10

 

三、属性注释

/**

  * {description}

  */

 

四、特殊注释标记 TODO:

idea常用java代码段模板 idea代码规范_idea常用java代码段模板_11

todo: 显示模板

//TODO $user$ $date$ $time$ [预计处理时间]

待办事宜(TODO):( 标记人,标记时间,[预计处理时间])

 

查看所有的todo 快捷键

Alt+6:查看所有TODO

 

五、代码业务修改:

业务逻辑修改:显示模板

 /** Edit By $user$ When $date$ $time$  请简单说明 参数、返回值、异常、核心逻辑 等的修改*/

//Edit End

 

idea常用java代码段模板 idea代码规范_单行注释_12

 

 

六、方法内部单行注释

方法内部单行注释,在被注释语句上方另起一行,使用//注释。方法内部多行注释 使用/* */注释,注意与代码对齐。

 

附录一 Edit variables的含义

idea常用java代码段模板 idea代码规范_自定义_13

idea常用java代码段模板 idea代码规范_单行注释_14

idea常用java代码段模板 idea代码规范_idea常用java代码段模板_15

 

idea常用java代码段模板 idea代码规范_自定义_16

用心编辑每一篇原创作品,深入理解每一个知识,理解源码,专注思想。目标进入大厂做自己想做的方向。如果你觉得好的话,可以评论或者关注我。