IDEA自动生成类和方法注释

本文介绍了如何在IDEA中设置和使用注释模板,包括类注释和方法注释。类注释涉及作者、创建日期和描述,方法注释提供参数、返回值信息。用户可以通过预设的模板,在创建新类或方法时自动生成规范的注释,提高编码效率。

效果图

 一、类注释

1. 创建

 

2. 向header文件中添加内容

/**
 * @author: 作者
 * @create: ${YEAR}-${MONTH}-${DAY} ${HOUR}:${MINUTE}
 * @Description: 
 */

3. class文件关联header配置

4. 使用方法

创建类时候自动生成。

二、方法注释

1. 

 

 输入模板内容:

注意格式不要修改了,否则会乱。

*
    * @Description:
    * $VAR1$
$params$ * @return $returns$
        */

 

VAR1参数内容:

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

returns参数内容:

methodReturnType()

 修改关联文件类型和内容:

三、使用方法

方法注释前先按Tab,再键入 /** ,最后按回车。

    /**

 四、参考文章

idea自动生成方法注释(含参数、返回值、日期、作者)

IDEA设置自动生成类和方法注释

优化 IntelliJ IDEA 自动生成注释方法注释,可从以下方面着手: - **注释优化**: - **调整模板内容**:在 `File -> Settings/Preferences -> Editor -> File and Code Templates -> Files` 中,选择如 `Class` 等文件型,修改注释模板。例如将默认的 `/** * ClassName * * @Description //TODO * @Author $user$ * @Date ${DATE} ${TIME} **/` 中的 `//TODO` 改为更具体的描述提示,像 `@Description 该主要用于处理 [具体业务模块] 的相关逻辑` [^1][^5]。 - **添更多元数据**:根据项目需求添如 `@Version` 表明的版本号、`@Since` 说明从哪个版本开始引入等。示例如下: ```java /** * ClassName * * @Description 该主要用于处理用户信息的增删改查操作 * @Author $user$ * @Date ${DATE} ${TIME} * @Version 1.0 * @Since 1.2 */ ``` - **方法注释优化**: - **完善参数返回值描述**:IDEA 自动生成方法注释对于参数返回值描述可能不够详细,可手动完善。例如在 `Live Templates` 中自定义方法注释模板,使用脚本获取方法的参数返回值信息,并添详细描述。 - **异常信息补充**:对于可能抛出的异常,详细说明异常产生的条件。示例如下: ```java /** * 计算两个整数的商 * * @param dividend 被除数 * @param divisor 除数 * @return 两个整数的商 * @throws ArithmeticException 当除数为 0 时抛出此异常 */ public int divide(int dividend, int divisor) { if (divisor == 0) { throw new ArithmeticException("除数不能为 0"); } return dividend / divisor; } ``` - **去除警告**:设置注释模板后可能会出现黄色警告,可通过调整模板语法或配置 IDEA注释检查规则来去除。例如,确保注释中的标签使用规范,避免使用不被支持的标签或语法错误 [^4]。
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值