IDEA类和方法注释模板设置（非常详细）

柔情只为你懂 2022-04-23 02:24 271阅读 0赞

转载于：[https://blog.csdn.net/xiaoliulang0324/article/details/79030752][https_blog.csdn.net_xiaoliulang0324_article_details_79030752]

# [Intellij IDEA使用教程相关系列 目录][Intellij IDEA_] #

--------------------

本文属于转载文章，因为文章大量都是图片，所以会加入一些文字，方便有需要的人复制

--------------------

IDEA自带的注释模板不是太好用，我本人到网上搜集了很多资料系统的整理了一下制作了一份比较完整的模板来分享给大家，我不是专业玩博客的，写这篇文章只是为了让大家省事。

这里设置的注释模板采用Eclipse的格式，下面先贴出Eclipse的注释模板，我们就按照这种格式来设置：

类注释模板：                                                                      方法注释模板：

![20190308104057448.png][]      ![20190308104103517.png][]

一、首先我们来设置IDEA中类的模板：（IDEA中在创建类时会自动给添加注释）

1、File-->settings-->Editor-->File and Code Templates-->Files

我们选择Class文件（当然你要设置接口的还也可以选择Interface文件）

（1）$\{NAME\}：设置类名，与下面的$\{NAME\}一样才能获取到创建的类名

（2）TODO：代办事项的标记，一般生成类或方法都需要添加描述

（3）$\{USER\}、$\{DATE\}、$\{TIME\}：设置创建类的用户、创建的日期和时间，这些事IDEA内置的方法，还有一些其他的方法在绿色框标注的位置，比如你想添加项目名则可以使用$\{PROJECT\_NAME\}

（4）1.0：设置版本号，一般新创建的类都是1.0版本，这里写死就可以了

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NoaV9ob25nX2ZlaV9oZWk_size_16_color_FFFFFF_t_70][]

**提供可复制的模板**

/**
     *@ClassName ${NAME}
     *@Description TODO
     *@Author zenghw
     *@Date ${DATE} ${TIME} 
     */

创建类时，有可能会出现这个：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NoaV9ob25nX2ZlaV9oZWk_size_16_color_FFFFFF_t_70 1][]

解决方案：

*  file 》 settings》File and Code Templates
 *  中间的，选择 includes ，选中File Header。
 *  清空，保存更新。
 *  ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NoaV9ob25nX2ZlaV9oZWk_size_16_color_FFFFFF_t_70 2][]

2、效果图展示

![20190308104129353.png][]

二、设置方法注释模板

IDEA还没有智能到自动为我们创建方法注释，这就是要我们手动为方法添加注释，使用Eclipse时我们生成注释的习惯是

/\*\*+Enter，这里我们也按照这种习惯来设置IDEA的方法注释

1、File-->Settings-->Editor-->Live Templates

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NoaV9ob25nX2ZlaV9oZWk_size_16_color_FFFFFF_t_70 3][]

（1）新建组：命名为userDefine

![20190308104145994.png][]

（2）新建模板：命名为\*

![2019030810415382.png][]

因为IDEA生成注释的默认方式是：/\*+模板名+快捷键（比如若设置模板名为add快捷键用Tab，则生成方式为

/\*add+Tab），如果不采用这样的生成方式IDEA中没有内容的方法将不可用，例如获取方法参数的methodParameters(）、

获取方法返回值的methodReturnType(）

（3）设置生成注释的快捷键

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NoaV9ob25nX2ZlaV9oZWk_size_16_color_FFFFFF_t_70 4][]

（4）设置模板：模板内容如下

注意第一行，只有一个\*而不是/\*

在设置参数名时必须用$\{参数名\}$的方式，否则第五步中读取不到你设置的参数名

如果使用/\*生成的模板注释将会是如下效果：所以我们要去掉最前面的/\*

![20190308104243485.png][]

**可复制模板：**

*
     * @Description //TODO 
     * @Date $date$ $time$
    $param$ 
     *@return $return$
     **/

（5）设置模板的应用场景

点击模板页面最下方的警告，来设置将模板应用于那些场景，一般选择EveryWhere-->Java即可

（如果曾经修改过，则显示为change而不是define）

![20190308104252840.png][]

![20190308104302998.png][]

（6）设置参数的获取方式

选择右侧的Edit variables按钮

PS:第五步和第六步顺序不可颠倒，否则第六步将获取不到方法

![20190308104313906.png][]

选择每个参数对应的获取方法（在下拉选择框中选择即可）

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NoaV9ob25nX2ZlaV9oZWk_size_16_color_FFFFFF_t_70 5][]

多参数时要用脚本来处理，复制下面这段代码到上面的位置

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())

（7）效果图

创建方法，在方法上面操作：-->/\*\*+Enter

![20191211165454687.png][]

[https_blog.csdn.net_xiaoliulang0324_article_details_79030752]: https://blog.csdn.net/xiaoliulang0324/article/details/79030752
[Intellij IDEA_]: https://blog.csdn.net/shi_hong_fei_hei/article/details/86597433
[20190308104057448.png]: https://img-blog.csdnimg.cn/20190308104057448.png
[20190308104103517.png]: /images/20220323/0b08fc5e5d644acca5f9f48cfb524eef.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NoaV9ob25nX2ZlaV9oZWk_size_16_color_FFFFFF_t_70]: /images/20220323/b4272f30e3804aef99cbfbbda380ccc7.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NoaV9ob25nX2ZlaV9oZWk_size_16_color_FFFFFF_t_70 1]: /images/20220323/1a74688062d54023b0e6057c08b9f3cf.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NoaV9ob25nX2ZlaV9oZWk_size_16_color_FFFFFF_t_70 2]: /images/20220323/a88af1edfabf4f9f8e0c0da4584aecd2.png
[20190308104129353.png]: /images/20220323/2e8e9874a71e4ffda4f5cf7ed858bb7b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NoaV9ob25nX2ZlaV9oZWk_size_16_color_FFFFFF_t_70 3]: /images/20220323/b85d013d384840f2b61a09cb998f9dae.png
[20190308104145994.png]: /images/20220323/eb68f814493b4a93841490347b34fbd8.png
[2019030810415382.png]: /images/20220323/5c70c503591241fe9d91747764efded3.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NoaV9ob25nX2ZlaV9oZWk_size_16_color_FFFFFF_t_70 4]: /images/20220323/385c079c1b87406bb2c530499aff538b.png
[20190308104243485.png]: /images/20220323/6babc37fabcf4c84bb777d571a376fbd.png
[20190308104252840.png]: /images/20220323/3187a3f2080b4508abdda5bad61280c9.png
[20190308104302998.png]: /images/20220323/151159d2a48d4e579bca84649090244b.png
[20190308104313906.png]: /images/20220323/48f78d72300743e5acaf93ff78c72f3d.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3NoaV9ob25nX2ZlaV9oZWk_size_16_color_FFFFFF_t_70 5]: /images/20220323/079c0a616cfb4e61bb986e1f5f2996a9.png
[20191211165454687.png]: /images/20220323/9c01d57c53404613b1657b225e873492.png