idea 修改 类注释及方法注释模板

IDEA代码注释自动生成
本文介绍如何在IntelliJ IDEA中配置自动生成文件头注释和方法注释,通过设置Preferences和LiveTemplates,实现高效规范的代码注释生成。

生成类注释
打开Preferences
Editor -> File and Code Templates -> includes --->File Header
 在这里插入图片描述
模板:

/**
 * @ClassName ${NAME}.java
 * @author liuhua
 * @version 1.0.0
 * @Description TODO
 * @createTime ${YEAR}-${MONTH}-${DAY}- ${HOUR}:${MINUTE}:00
 */ 
 
 二、定义方法注释模板
File -> Settings -> Editor -> Live Templates

在Live Templates 右侧点击+号,添加一个Templates Group,命名为 methodTemplates

  在这里插入图片描述
模板:

*
 * @Author liuhua
 * @Description //TODO $end$
 * @Date $date$ $time$ $param$ $return$
 **/

 在这里插入图片描述


**param :**

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


**return :**

groovyScript("def result=''; def data=\"${_1}\"; def stop=false; if(data==null || data=='null' || data=='' || data=='void' ) { stop=true; }; if(!stop) { result += '\\r\\n' + ' * @return: ' + data; }; return result;", methodReturnType())
2)、在位置3下方,点击选择该模板应用的范围,可选Everywhere 表示任何位置都可添加该注释

 在这里插入图片描述

<think>嗯,用户需要配置IntelliJ IDEA注释模板,我需要根据提供的引用信息整理出详细步骤。用户明确提到了"注释模板",所以重点在文件级别的注释设置。 用户给出的引用包含了多个关键信息点:引用[2]和引用[4]都提到了通过File → Settings → Editor → File and Code Templates路径设置注释模板。引用[3]补充了自定义作者名称的方法,引用[5]则提供了方法参数注释的Groovy脚本配置。 用户可能实际操作时会遇到变量不生效的情况,需要特别提醒模板变量格式${VARIABLE}的注意事项。考虑到用户是开发人员,应该需要知道如何自定义日期格式和作者名称这些实用技巧。 在整理步骤时,建议把最常用的设置方式放在前面,即引用[4]展示的直接编辑Class模板的方式。然后是可选的自定义作者名称方法(引用[3])和方法参数模板配置(引用[5])。最后补充用户可能需要的日期格式调整技巧,虽然引用里没直接提,但属于常见需求。 用户可能还会想知道如何验证模板是否生效,需要包含创建新文件的测试步骤。考虑到模板配置的复杂性,最好在最后给出参考引用标注方便用户溯源。 </think>以下是IntelliJ IDEA配置注释模板的详细步骤(整合官方文档及最佳实践): ### 📝 一、基础配置步骤 1️⃣ **打开设置面板** `File` → `Settings` (Windows/Linux) 或 `IntelliJ IDEA` → `Preferences` (macOS) 2️⃣ **进入模板配置页** 路径:`Editor` → `File and Code Templates` → `Files` 标签 → 选择 `Class`(或`Interface`等)[^2][^4] 3️⃣ **编辑模板内容** 在右侧编辑区添加注释模板(示例): ```java /** * @author ${USER} * @date ${DATE} ${TIME} * @version 1.0 * @description TODO */ ``` > ✅ **模板变量说明**: - `${USER}`:系统用户名(可自定义) - `${DATE}`/`${TIME}`:当前日期时间 - `${YEAR}`/`${MONTH}`/`${DAY}`:独立日期组件[^4] 4️⃣ **应用生效** 创建新时将自动生成注释: ```java /** * @author jitwxs * @date 2023年10月25日 14:30 * @version 1.0 * @description TODO */ public class Demo {} ``` ### ️ 二、高级配置技巧 1. **自定义作者名**(覆盖系统用户) 修改IDEA配置文件:`Help` → `Edit Custom VM Options...` 添加行:`-Duser.name=YourName` 并重启IDE[^3] 2. **日期格式定制** 修改模板变量(示例): ```java ${DATE?replace("(\\d+)/(\\d+)/(\\d+)", "$3-$1-$2")} // 将 MM/dd/yyyy 转为 yyyy-MM-dd 格式 ``` 3. **兼容方法参数注释** 需在 `Live Templates` 中单独配置`method`模板,使用Groovy脚本处理参数[^5]: ```groovy groovyScript("...", methodParameters()) ``` ### 🔍 三、验证与调试 - **即时生效**:新建文件自动应用模板 - **旧项目迁移**:需手动添加或使用重构工具 - **变量失效处理**:检查`$`符号是否被转义,确保使用`${VAR}`格式 > 📌 **注意事项**: > 1. 注释模板仅对新创建文件生效 > 2. 涉及脚本配置需确保启用Groovy支持[^5] > 3. 团队开发建议导出模板设置(`File` → `Manage IDE Settings` → `Export`)
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值