转载idea生成代码注释,今天你写注释了吗?

idea:

类头注释:打开file->setting->Editor->Filr and Code Templates->Includes->File Header 
这里写图片描述
直接在右边的文件框里编辑你说需要注释的东西,然后应用保存之后,当你创建类的时候就会自动生成注释。

方法注释:打开file->setting->Editor->LiveTemplates点击右边上面那个绿色的+号,选择Template Group双击,然后弹出一个窗口,随便添加一个名字,我这里添加的是MyGroup然后点击OK 
这里写图片描述

还是在file->setting->Editor->LiveTemplates这个路径下点击一下刚刚你添加的那个名字(我这是MyGroup),然后点击右边上面那个绿色的+号,选择LiveTemplate双击,填写下面的图上的框 
这里写图片描述
然后点击这里写图片描述 
然后选择Everywhere 
这里写图片描述

最后点击右下角的Edit variables 按钮,然后弹出一个窗口,如下: 
这里写图片描述
如果想把 @param:每一个参数可以这样 
这里写图片描述
参数值要自己写的

groovyScript(“def result=”; def params=\”$<span class="hljs-special">{</span>_1<span class="hljs-special">}</span><span class="hljs-command">\"</span>.replaceAll('<span class="hljs-special">[</span><span class="hljs-command">\\</span><span class="hljs-command">\\</span><span class="hljs-special">[</span>|<span class="hljs-command">\\</span><span class="hljs-command">\\</span><span class="hljs-special">]</span>|<span class="hljs-command">\\</span><span class="hljs-command">\\</span>s<span class="hljs-special">]</span>', '').split(',').toList(); for(i = 0; i &lt; params.size(); i++) <span class="hljs-special">{</span>result+=' * @param ' + params<span class="hljs-special">[</span>i<span class="hljs-special">]</span> + ((i &lt; params.size() - 1) ? '<span class="hljs-command">\\</span>n<span class="hljs-command">\\</span>b' : '')<span class="hljs-special">}</span>; return result", methodParameters())</span></code></pre><ul class="pre-numbering"><li style="color:rgb(153,153,153);">1</li></ul><p style="font-family:'-apple-system', 'SF UI Text', Arial, 'PingFang SC', 'Hiragino Sans GB', 'Microsoft YaHei', 'WenQuanYi Micro Hei', sans-serif, SimHei, SimSun;background-color:rgb(255,255,255);">把这个添加进去,但是还要注意一点:&nbsp;<br><img src="https://img-blog.csdn.net/20161202131406143" alt="这里写图片描述" title="" style="margin-top:24px;margin-bottom:24px;">&nbsp;<br>下面红色圈中的下拉框选择相对应的参数点击OK&nbsp;<br>再点击apply,点击Ok。&nbsp;<br></p><p>然后写方法之前点写上add(刚刚填的)按tab,注释就出来了。</p><p><br></p><h2><a name="t1"></a><strong>第二篇</strong></h2><p>-------------------------------------------------------------------------------------</p><p></p><p style="background-color:rgb(255,255,255);">IDEA自带的注释模板不是太好用,我本人到网上搜集了很多资料系统的整理了一下制作了一份比较完整的模板来分享给大家,我不是专业玩博客的,写这篇文章只是为了让大家省事。</p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"></span>这里设置的注释模板采用Eclipse的格式,下面先贴出Eclipse的注释模板,我们就按照这种格式来设置:</p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"></span>类注释模板:&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 方法注释模板:</p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><img src="https://img-blog.csdn.net/20180111094050403?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveGlhb2xpdWxhbmcwMzI0/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast" alt=""></span>&nbsp; &nbsp;&nbsp;<img src="https://img-blog.csdn.net/20180111094203828?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveGlhb2xpdWxhbmcwMzI0/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast" alt=""></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"></span>一、首先我们来设置IDEA中类的模板:(IDEA中在创建类时会自动给添加注释)</p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"></span>1、File--&gt;settings--&gt;Editor--&gt;File and Code Templates--&gt;Files</p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"></span>我们选择Class文件(当然你要设置接口的还也可以选择Interface文件)</p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"></span>(1)${NAME}:设置类名,与下面的${NAME}一样才能获取到创建的类名</p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"></span>(2)TODO:代办事项的标记,一般生成类或方法都需要添加描述</p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"></span>(3)${USER}${DATE}、${TIME}:设置创建类的用户、创建的日期和时间,这些事IDEA内置的方法,还有一些其他的方法在绿色框标注的位置,比如你想添加项目名则可以使用${PROJECT_NAME}<br></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"></span>(4)1.0:设置版本号,一般新创建的类都是1.0版本,这里写死就可以了</p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><span></span><img src="https://img-blog.csdn.net/20180111094802573?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveGlhb2xpdWxhbmcwMzI0/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast" alt=""></span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><span></span>2、效果图展示</span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><img src="https://img-blog.csdn.net/20180111095826897?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveGlhb2xpdWxhbmcwMzI0/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast" alt=""></span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><span></span>二、设置方法注释模板</span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><span></span>IDEA还没有智能到自动为我们创建方法注释,这就是要我们手动为方法添加注释,使用Eclipse时我们生成注释的习惯是</span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><span></span>/**+Enter,这里我们也按照这种习惯来设置IDEA的方法注释</span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><span></span>1、File--&gt;Settings--&gt;Editor--&gt;Live Templates</span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><span></span><img src="https://img-blog.csdn.net/20180111101422713?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveGlhb2xpdWxhbmcwMzI0/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast" alt=""></span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><span></span>(1)新建组:命名为userDefine</span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><img src="https://img-blog.csdn.net/20180111101509270?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveGlhb2xpdWxhbmcwMzI0/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast" alt=""></span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><span></span><span style="color:rgb(255,0,0);">(2)新建模板:命名为*</span></span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><span><span><span><span style="color:rgb(255,0,0);"><span></span>因为IDEA生成注释的默认方式是:/*+模板名+快捷键(比如若设置模板名为add快捷键用Tab,则生成方式为</span></span></span></span></span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><span><span><span><span style="color:rgb(255,0,0);"><span></span>/*add+Tab),如果不采用这样的生成方式IDEA中没有内容的方法将不可用,例如获取方法参数的methodParameters()、</span></span></span></span></span></p><p style="background-color:rgb(255,255,255);"><span style="color:rgb(255,0,0);"><span style="white-space:pre;"></span>获取方法返回值的methodReturnType()</span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><img src="https://img-blog.csdn.net/20180111101620220?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveGlhb2xpdWxhbmcwMzI0/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast" alt=""></span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><span></span>(3)设置生成注释的快捷键</span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><img src="https://img-blog.csdn.net/20180111102440886?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveGlhb2xpdWxhbmcwMzI0/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast" alt=""></span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><span></span>(4)设置模板:模板内容如下</span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><span></span>注意第一行,只有一个*而不是/*</span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><span></span>在设置参数名时必须用${参数名}$的方式,否则第五步中读取不到你设置的参数名

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

(5)设置参数的获取方式

选择右侧的Edit variables按钮

选择每个参数对应的获取方法(在下拉选择框中选择即可),网上有很多教程说获取param时使用脚本的方式,我试过使用脚本

扫描二维码关注公众号,回复: 1641257 查看本文章

的方式不仅麻烦而且只能在方法内部使用注释时才能获取到参数

(6)设置模板的应用场景

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

(如果曾经修改过,则显示为change而不是define)

(7)效果图

创建方法,在方法上面写:/*+模板名+Enter–>/**+Enter



个人用的模板:
类上:

/**
 *@Description: 
 *@CreateBy: tristan('3301015948@qq.com')
 *@CreateDate: ${TIME} ${DATE}
 *@UpdateBy: tristan('3301015948@qq.com')
 *@UpdateDate: ${TIME} ${DATE}
 *@Location: ${PACKAGE_NAME}
 */

方法上

*
*@Description: 注释
*@Params: $Params$
*@Return: $Return$
*@CreateBy: tristan('[email protected]')  *@CreateDate: $nowDate$ $nowTime$
*@UpdateBy: tristan('[email protected]')  *@UpdateDate: $nowDate$ $nowTime$
*@Location: $Location$
*/

idea:

类头注释:打开file->setting->Editor->Filr and Code Templates->Includes->File Header 
这里写图片描述
直接在右边的文件框里编辑你说需要注释的东西,然后应用保存之后,当你创建类的时候就会自动生成注释。

方法注释:打开file->setting->Editor->LiveTemplates点击右边上面那个绿色的+号,选择Template Group双击,然后弹出一个窗口,随便添加一个名字,我这里添加的是MyGroup然后点击OK 
这里写图片描述

还是在file->setting->Editor->LiveTemplates这个路径下点击一下刚刚你添加的那个名字(我这是MyGroup),然后点击右边上面那个绿色的+号,选择LiveTemplate双击,填写下面的图上的框 
这里写图片描述
然后点击这里写图片描述 
然后选择Everywhere 
这里写图片描述

最后点击右下角的Edit variables 按钮,然后弹出一个窗口,如下: 
这里写图片描述
如果想把 @param:每一个参数可以这样 
这里写图片描述
参数值要自己写的

groovyScript(“def result=”; def params=\”$<span class="hljs-special">{</span>_1<span class="hljs-special">}</span><span class="hljs-command">\"</span>.replaceAll('<span class="hljs-special">[</span><span class="hljs-command">\\</span><span class="hljs-command">\\</span><span class="hljs-special">[</span>|<span class="hljs-command">\\</span><span class="hljs-command">\\</span><span class="hljs-special">]</span>|<span class="hljs-command">\\</span><span class="hljs-command">\\</span>s<span class="hljs-special">]</span>', '').split(',').toList(); for(i = 0; i &lt; params.size(); i++) <span class="hljs-special">{</span>result+=' * @param ' + params<span class="hljs-special">[</span>i<span class="hljs-special">]</span> + ((i &lt; params.size() - 1) ? '<span class="hljs-command">\\</span>n<span class="hljs-command">\\</span>b' : '')<span class="hljs-special">}</span>; return result", methodParameters())</span></code></pre><ul class="pre-numbering"><li style="color:rgb(153,153,153);">1</li></ul><p style="font-family:'-apple-system', 'SF UI Text', Arial, 'PingFang SC', 'Hiragino Sans GB', 'Microsoft YaHei', 'WenQuanYi Micro Hei', sans-serif, SimHei, SimSun;background-color:rgb(255,255,255);">把这个添加进去,但是还要注意一点:&nbsp;<br><img src="https://img-blog.csdn.net/20161202131406143" alt="这里写图片描述" title="" style="margin-top:24px;margin-bottom:24px;">&nbsp;<br>下面红色圈中的下拉框选择相对应的参数点击OK&nbsp;<br>再点击apply,点击Ok。&nbsp;<br></p><p>然后写方法之前点写上add(刚刚填的)按tab,注释就出来了。</p><p><br></p><h2><a name="t1"></a><strong>第二篇</strong></h2><p>-------------------------------------------------------------------------------------</p><p></p><p style="background-color:rgb(255,255,255);">IDEA自带的注释模板不是太好用,我本人到网上搜集了很多资料系统的整理了一下制作了一份比较完整的模板来分享给大家,我不是专业玩博客的,写这篇文章只是为了让大家省事。</p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"></span>这里设置的注释模板采用Eclipse的格式,下面先贴出Eclipse的注释模板,我们就按照这种格式来设置:</p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"></span>类注释模板:&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 方法注释模板:</p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><img src="https://img-blog.csdn.net/20180111094050403?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveGlhb2xpdWxhbmcwMzI0/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast" alt=""></span>&nbsp; &nbsp;&nbsp;<img src="https://img-blog.csdn.net/20180111094203828?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveGlhb2xpdWxhbmcwMzI0/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast" alt=""></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"></span>一、首先我们来设置IDEA中类的模板:(IDEA中在创建类时会自动给添加注释)</p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"></span>1、File--&gt;settings--&gt;Editor--&gt;File and Code Templates--&gt;Files</p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"></span>我们选择Class文件(当然你要设置接口的还也可以选择Interface文件)</p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"></span>(1)${NAME}:设置类名,与下面的${NAME}一样才能获取到创建的类名</p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"></span>(2)TODO:代办事项的标记,一般生成类或方法都需要添加描述</p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"></span>(3)${USER}${DATE}、${TIME}:设置创建类的用户、创建的日期和时间,这些事IDEA内置的方法,还有一些其他的方法在绿色框标注的位置,比如你想添加项目名则可以使用${PROJECT_NAME}<br></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"></span>(4)1.0:设置版本号,一般新创建的类都是1.0版本,这里写死就可以了</p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><span></span><img src="https://img-blog.csdn.net/20180111094802573?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveGlhb2xpdWxhbmcwMzI0/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast" alt=""></span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><span></span>2、效果图展示</span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><img src="https://img-blog.csdn.net/20180111095826897?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveGlhb2xpdWxhbmcwMzI0/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast" alt=""></span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><span></span>二、设置方法注释模板</span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><span></span>IDEA还没有智能到自动为我们创建方法注释,这就是要我们手动为方法添加注释,使用Eclipse时我们生成注释的习惯是</span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><span></span>/**+Enter,这里我们也按照这种习惯来设置IDEA的方法注释</span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><span></span>1、File--&gt;Settings--&gt;Editor--&gt;Live Templates</span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><span></span><img src="https://img-blog.csdn.net/20180111101422713?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveGlhb2xpdWxhbmcwMzI0/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast" alt=""></span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><span></span>(1)新建组:命名为userDefine</span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><img src="https://img-blog.csdn.net/20180111101509270?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveGlhb2xpdWxhbmcwMzI0/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast" alt=""></span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><span></span><span style="color:rgb(255,0,0);">(2)新建模板:命名为*</span></span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><span><span><span><span style="color:rgb(255,0,0);"><span></span>因为IDEA生成注释的默认方式是:/*+模板名+快捷键(比如若设置模板名为add快捷键用Tab,则生成方式为</span></span></span></span></span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><span><span><span><span style="color:rgb(255,0,0);"><span></span>/*add+Tab),如果不采用这样的生成方式IDEA中没有内容的方法将不可用,例如获取方法参数的methodParameters()、</span></span></span></span></span></p><p style="background-color:rgb(255,255,255);"><span style="color:rgb(255,0,0);"><span style="white-space:pre;"></span>获取方法返回值的methodReturnType()</span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><img src="https://img-blog.csdn.net/20180111101620220?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveGlhb2xpdWxhbmcwMzI0/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast" alt=""></span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><span></span>(3)设置生成注释的快捷键</span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><img src="https://img-blog.csdn.net/20180111102440886?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveGlhb2xpdWxhbmcwMzI0/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast" alt=""></span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><span></span>(4)设置模板:模板内容如下</span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><span></span>注意第一行,只有一个*而不是/*</span></p><p style="background-color:rgb(255,255,255);"><span style="white-space:pre;"><span></span>在设置参数名时必须用${参数名}$的方式,否则第五步中读取不到你设置的参数名

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

(5)设置参数的获取方式

选择右侧的Edit variables按钮

选择每个参数对应的获取方法(在下拉选择框中选择即可),网上有很多教程说获取param时使用脚本的方式,我试过使用脚本

的方式不仅麻烦而且只能在方法内部使用注释时才能获取到参数

(6)设置模板的应用场景

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

(如果曾经修改过,则显示为change而不是define)

(7)效果图

创建方法,在方法上面写:/*+模板名+Enter–>/**+Enter



个人用的模板:
类上:

猜你喜欢

转载自blog.csdn.net/qq_35559756/article/details/80719207