【idea技巧篇】idea的类注释和方法注释模版自定义设置

这块idea技巧虽然常用，谁没事会经常修改模版设置呢，一般是搭建开发环境的时候或者开发规范要求等设置一次就行了。用的虽然少，但几乎每次搭建环境都会用到，这里记录下并分享设置的过程已经发现的更高级的一些使用技巧。

注释模版

idea默认创建java文件时，是不会生成类注释的，但是一般要求统一格式，需要带上类的注释，下图是一个简单的模版，具体模版可以自定义设置，这里分享下如何设置注释模版。

如何设置

设置文件头方式

效果就是每次创建java文件，会自动带上注释内容。这种方式设置比较简单，只适用于新建Java文件时生效，而且全局统一，推荐使用这种方式进行全局设置。

配置路径：Settings -> Editor -> File and Code Templates -> File Header

配置内容：

java 复制代码

/**
 * 负责实验执行，故障摘除等逻辑
 * @author: wanglianhai
 * @date: 2024/8/9 16:52
 */

效果如下：

可用的变量如下：

预定义变量取以下值：

${PACKAGE_NAME}新文件创建时所属的包名

${USER}当前用户的系统登录名

${DATE}当前系统日期

${TIME}当前系统时间

${YEAR}当前年份

${MONTH}当前月份

${MONTH_NAME_SHORT}当前月份名称的前三个字母。例如：Jan, Feb等

${MONTH_NAME_FULL}当前月份的全名。例如：January, February等

${DAY}当前月中的日期

${DAY_NAME_SHORT}当前星期名称的前三个字母。例如：Mon, Tue等

${DAY_NAME_FULL}当前星期的全名。例如：Monday, Tuesday等

${HOUR}当前小时

${MINUTE} 当前分钟

${PROJECT_NAME} 当前项目名称

通过模版自定义

Live Template这种方式可以自定义很多模版以及快捷的设置，而且可以参考注释模版的设置，然后去拓展定义其他模版。

配置路径：settings -> Editor -> Live Templates，如下图：
创建Template

模版：

java 复制代码

/**
* Description: <br/>
* @date: $DATE$ $TIME$<br/>
* @author: your name <br/>
* @since JDK 1.8
*/

看到其中有DATE和TIME变量，还需编辑变量，同理参考这种方式，可以设置用户名等其他变量，内置了很多变量，下拉可以查看。
效果：

回车生成注释内容

进阶使用

设置变量函数，上一篇已经看到有内置的函数了，同时我们也可以自定义自己的函数如下图：

我们尝试设置JavaDoc格式的方法注释模版：

模版内容，注意下面内容是只有一个*，这样快捷键可以设置成*, 不然会取不到方法参数。

java 复制代码

*
 * @description
 * @author xiaohei 
 * @date $date$ $time$
 * @param $param$
 * @return $return$
 **/

获取参数param的脚本：

groovy 复制代码

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

获取返回值脚本：

groovy 复制代码

groovyScript("return \"${_1}\" == 'void' ? null : '\\r\\n * @return ' + \"${_1}\"", methodReturnType())

其他Live Template

参考如下，可以设置各种编程语言的快捷键已经自动生成的内容，参考如下图：

常见的模版内容参考

类注释模版

最简单的类注释模版, 我一般使用这种，比较简介明了，生成完添加下类的功能说明就好了，需要其他信息可以

java 复制代码

/**
 * 
 * @author: xiaohie
 * @date: ${DATE} ${TIME}
 */

复杂一点的

java 复制代码

/**
 * @className: XXDemo
 * @description: 演示使用
 * @author: xiaohei
 * @date: $date$ $time$
 **/

方法注释模版

我一般就用默认的就够了，如果需要调整可以参考以下几种模版：

java 复制代码

*
 $param$
 * @description: TODO
 * @return: $return$
 * @author: xiaohei
 * @date: $date$ $time$
 */