idea上关于类、接口、方法的默认注释

idea上关于类、接口、方法的默认注释

类的注释

在settings的File and Code Templates中找到class。在右边输入注释格式。
在这里插入图片描述
变量使用${}的形式。

#if (${PACKAGE_NAME} && ${PACKAGE_NAME} != "")package ${PACKAGE_NAME};#end
#parse("File Header.java")

/**
 * @ClassName ${NAME}
 * @Description 添加描述
 * @Author Waynejwei
 * @LastChangeDate ${DATE} ${TIME}
 * @Version v1.0
 */
 
public class ${NAME} {
}

添加以后每次创建类便会默认显示注释。
在这里插入图片描述

接口注释

同样在settings的File and Code Templates中找到interface。

#if (${PACKAGE_NAME} && ${PACKAGE_NAME} != "")package ${PACKAGE_NAME};#end
#parse("File Header.java")

/**
 * @InterfaceName ${NAME}
 * @Description 添加描述
 * @Author Waynejwei
 * @LastChangeDate ${DATE} ${TIME}
 * @Version v1.0
 */

public interface ${NAME} {
}

方法注释

在settings的LiveTemplates中点击+号,添加注释
在这里插入图片描述

/**
 * @MethodName $methodName$
 * @Param $param$
 * @Description 添加描述
 * @Return $return$
 * @LastChangeDate $LastChangeDate$
 * @Version v1.0
 */

此时获取方法中的内容使用$name$

### 配置 IntelliJ IDEA 新建方法自动生成注释模板 在 IntelliJ IDEA 中,可以通过配置 **File and Code Templates** 来实现新建方法自动生成注释的功能。该功能支持在创建 Java 接口自动插入描述、作者信息、创建间等内容,在定义方法自动生成 Javadoc 格式的注释,包括参数、返回值等信息。 #### 配置注释模板 在 IntelliJ IDEA 中,可以通过以下路径设置的文件头注释: - 打开设置界面:`File → Settings → Editor → File and Code Templates → Includes → File Header` - 在模板中添加如下内容: ```java /** * @ClassName ${NAME} * @author: 作者 * @Description TODO * @date ${DATE} ${TIME} * @Version 1.0版本 */ ``` 该模板会在创建接口自动生成包含名、作者、描述、创建间和版本信息的注释头[^2]。 #### 配置方法注释模板 对于方法注释,IntelliJ IDEA 支持通过 **Live Templates** 功能实现自动生成。具体配置如下: - 打开设置界面:`File → Settings → Editor → Live Templates` - 创建一个新的模板组(避免修改默认模板组),然后添加一个新的实模板 - 设置缩写(如 `/**`),并在模板内容中输入以下结构: ```java /** * @Description: TODO * @Author: CJ * @Date: $date$ $time$ * @Param: $param$ * @return: $return$ */ ``` 其中,`$date$` 和 `$time$` 会自动替换为当前日期和间,`$param$` 和 `$return$` 会根据方法参数和返回值自动填充内容[^1]。 #### 使用注释模板 完成上述配置后,在编辑器中输入 `/**` 并按下回车键,IntelliJ IDEA 将自动生成 Javadoc 格式的方法注释,并根据上下文填充参数和返回值信息。对于文件,在创建会自动插入文件头注释,包括名、作者、描述、创建间和版本信息。 #### 注释模板的维护 建议根据团队规范对模板内容进行定制,例如统一作者名、描述格式、版本号等。同,应定期检查模板内容,确保其与项目规范保持一致,并根据需要更新注释结构以适应新的开发流程。 ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值