Idea配置Javadoc

方法一:自动生成类注释

在创建类的时候,自动生成类注释,打开Settings>Editor>File and Code Templates,Files页签下,选择Class/Interface,可以看到引用了#parse("File Header.java")模版:

自动生成类注释

所以我们来修改模版即可,Includes页签下,选择File Header模版,右侧即自定义模版,下面的Description中描述了支持的参数:
引用模版修改

配置模版如下:

/**
 * @Description TODO
 * @author ${USER}
 * @date ${DATE}-${TIME}
 */
测试自动生成类注释

方法二:自定义模版生成类(方法)注释

方法一只能在类定义时生成注释,如果想重新定义或给方法生成注释,则需要自定义模版进行配置,打开Settings>Editor>Live Templates,自定义一个模版组,来创建自己的模版:


创建自定义模版组

创建自定义模版

设置类注释及参数:

配置好以下内容后,在类上方输入/*c,按下Enter即可添加类注释:

**
 * $END$
 * TODO
 * @author $user$
 * @date $date$
 **/
  • 参数配置:date("yyyy-MM-dd HH:mm:ss"),设置完成后需要按Enter键,否则无法保存。
    类注释

设置方法注释及参数:

配置好以下内容后,在类上方输入/*m,按下Enter即可添加方法注释:

**
 * $END$
 * TODO
 * @author $user$
 * @date $date$
 $param$ 
 * @return $return$
 **/
  • ==开头不能有/,否则param显示错误==;
  • 参数配置:
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 ' : '')};return result", methodParameters())
方法注释

方法三:直接替换文件

是不是稍微有点麻烦...我找到了自定义模版存放的路径,文件名称即为模版组名称:

注释模版默认地址

不想手动配置的朋友可以在路径下创建一个XXX.xml文件,将下面的内容复制保存,重启一下Idea就可以直接使用了:


  
  

你可能感兴趣的:(Idea配置Javadoc)