idea类和方法配置注释模板

idea类和方法配置注释模板

viEcho Lv5

很多开源的代码,人家注释写的那叫个工整啊,一直知道idea可以配置各种模板,但是觉得简单一直没去弄;今天看了些博客配置,发现自己按照上面来配还是没有达到自己想要的要求,改动调整后才达到;

配置

我们要自己定义方法注释的模板,在Live Templates添加即可,但是我们要改默认的类上模板则需要File and Code TemplatesFile Header中增加配置,这样在类创建时就会按我们配置的生成注释;

1
2
3
4
5
/**
* @description: TODO
* @author: ${USER}
* @date: ${DATE}
*/

preferences–>Live Templates 点击右侧加号添加模板组,以我这里的配置为例,我自定义为definedTemplates

分别定义了类上注释和方法上的注释模板;

类模板(注意:第一个*号要最左,不是写错!)

1
2
3
4
5
*
* @description: TODO
* @auther: $user$
* @date: $date$
*/

方法模板

1
2
3
4
5
6
7
*
* @description: TODO
* @author: $user$
* @date: $date$
$params$
* @return: $return$
*/

$params$参数对应配置:

1
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) ? '\\r\\n ' : '')}; return result", methodParameters())


配置完,使他在java的配置中生效

注意📢 :我们配置的类名和方法名的缩写分别是*c,*f

那么我们在类上添加注释的方式就是输入/**+c和enter键,在方法上添加注释的方式是输入/**+f和enter键;

其实我们在File and Code TemplatesFile Header中增加了类的注释模板,类在创建时就如同我们/**+c和enter的效果一致,但很多时候我们用一些工具生成或者拷贝别人代码的时候,并不会重新创建类,当我们需要修改时就可以用到这个快捷键了;

效果如下,很多注释属性觉得没用,只保留了个人认为重要的一些注释:
gqIYxe.png

小结:本篇简要的介绍了类及方法上配置注释模板的方法,快配置完舒服一波吧;

  • Title: idea类和方法配置注释模板
  • Author: viEcho
  • Created at : 2021-05-22 13:37:47
  • Updated at : 2024-01-18 15:13:29
  • Link: https://viecho.github.io/2021/0522/idea-template-comment.html
  • License: This work is licensed under CC BY-NC-SA 4.0.
Comments
On this page
idea类和方法配置注释模板