如何设置idea代码注释格式

如何设置idea代码注释格式

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

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

类注释模板:                                                                      方法注释模板:

    如何设置idea代码注释格式      如何设置idea代码注释格式

一、首先我们来设置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版本,这里写死就可以了

如何设置idea代码注释格式

 

提供可复制的模板

  1. /

  2. *@ClassName ${NAME}

  3. *@Description TODO

  4. *@Author zenghw

  5. *@Date ${DATE} ${TIME}

  6. */

创建类时,有可能会出现这个:

如何设置idea代码注释格式

解决方案:

  • file 》 settings》File and Code Templates

  • 中间的,选择 includes ,选中File Header。

  • 清空,保存更新。

  • 如何设置idea代码注释格式

2、效果图展示

如何设置idea代码注释格式

 

二、设置方法注释模板

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

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

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

如何设置idea代码注释格式

(1)新建组:命名为userDefine

如何设置idea代码注释格式

(2)新建模板:命名为*

如何设置idea代码注释格式

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

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

获取方法返回值的methodReturnType()

(3)设置生成注释的快捷键

如何设置idea代码注释格式

(4)设置模板:模板内容如下

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

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

  

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

如何设置idea代码注释格式

可复制模板:

  1. *

  2. *
    @Description //TODO

  3. *
    @Date $date$ $time$

  4. *
    @param $param$

  5. *
    @return $return$

  6. /

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

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

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

如何设置idea代码注释格式

如何设置idea代码注释格式

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

选择右侧的Edit variables按钮

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

如何设置idea代码注释格式如何设置idea代码注释格式

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

如何设置idea代码注释格式

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


(7)效果图

创建方法,在方法上面操作:–>/+Enter

  如何设置idea代码注释格式

 

 转载于:https://blog.csdn.net/xiaoliulang0324/article/details/

今天的文章
如何设置idea代码注释格式分享到此就结束了,感谢您的阅读。

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 举报,一经查实,本站将立刻删除。
如需转载请保留出处:http://bianchenghao.cn/140883.html

(0)
编程小号编程小号
上一篇 2024-08-26 11:06
下一篇 2024-07-02

相关推荐