IDEA 类和方法的模板注释设置

IDEA注释模板配置
本文详细介绍如何在IntelliJ IDEA中配置类和方法的注释模板,包括自定义注释样式、日期格式及参数说明等内容,帮助提高开发效率。

1 类注释模板的设置

(1)File -------- Settings ------------ File and Code Templates
(2)在这里插入图片描述
如上图,选择 Class 选项,在 public class ${NAME} 这一行的上一行设置自己的模板。内容如下,可以根据自己的风格进行修改。

/**
     * description: ${description}
     * @author 张三
 	 * @date ${YEAR}-${MONTH}-${DAY} ${TIME}:${SECOND}
 	 * @version 
 	*/

在这里,我们使用${description}的方式的话,当我们新建一个类时会自动弹出一个编辑框输入类的说明(decription),当然你也可以直接写成文本。点击 ApplyOK

2 方法注释模板的设置

(1)File --------- Settings -------- Live Templates
(2)
在这里插入图片描述
新建自己的模板组名,名字根据自己的喜好自由填写即可。

(3)
在这里插入图片描述
在这里插入图片描述
Abbreviation 是后续我们在写代码时的快捷方式,比如我输入的是 add ,那么我们在写代码时,在类方法的上一行 输入 /* + add + 回车 就会自动生成方法注释。前提是我把快捷的一个选项 设置为了Enter , 默认是 Tab键 。你可以根据自己的喜好选择,如下图:
在这里插入图片描述
Template Text 是我们要生成的内容,以下内容可以作为参考,也可自行修改。

/**
	 * description:<方法说明>
     * @author 张三
	 * @date $date$ $time$
	 $params$
	 * @return $return$
	 */

(4)
在这里插入图片描述
以下是各个表达式,也可以根据自己的习惯自定义格式。

date: date("yyyy-MM-dd");
time: time("HH:mm:ss")。
params:groovyScript("def result=''; def params=\"${_1}\".replaceAll('[\\\\[|\\\\]|\\\\s]', '').split(',').toList(); for(i = 0; i < params.size(); i++) {result+='* @param ' + params[i] + ((i < params.size() - 1) ? '\\n ' : '')}; return result", methodParameters())
returns:methodReturnType()

(5)
在这里插入图片描述
勾选 JAVA ,最后点击 ApplyOK ,我们就可以快捷生成类和方法注释了。你学会了吗,IDEA 小白根据前辈的经验自己写的第一篇文章,记录成长,加油!!!

在 IntelliJ IDEA 中,为了提高代码文档化效率,你可以自定义方法注释模板。这样每次创建新方法时,只需填写少量内容IDEA就会自动填充完整的注释。以下是设置注释模板的基本步骤: 1. 打开 IntelliJ IDEA,选择 "File" -> "Settings" (Windows/Linux) 或 "IntelliJ IDEA" -> "Preferences" (macOS)。 2. 寻找并点击 "Editor",然后选择 "Code Style" -> "Live Templates"。 3. 在左侧栏中找到 "General", "JavaDoc" 或者更具体的语言区域(如 "Java"),展开它。 4. 双击 "Code Folders" 来编辑现有模板,或者点击 "+" 创建新的模板。例如,为方法分别设置模板,可以创建两个模板,如 "Class Comment" "Method Comment"。 5. 编辑模板内容。对于 `@param`、`@return` 等部分,可以用 `${...}` 标记表示需要用户输入的部分。例如,一个简单的注释模板可能如下: ``` /** * ${CLASS_NAME} - 描述的功能 * * ${DESCRIPTION} */ ``` 6. 对于方法模板,可能会包含输入参数名型的提示: ``` /** * ${METHOD_NAME}(参数列表) * - 描述方法的作用 * * @param 参数1_name ${PARAM1_TYPE} 参数1描述 * @param 参数2_name ${PARAM2_TYPE} 参数2描述 * ... * @return 返回值型 返回值描述 */ ``` 7. 设置完成后,记得保存更改。现在当你创建新的方法时,输入相应的触发短语(比如 "class" 或者 "method"),然后按回车键,IDEA 就会基于你的模板生成注释了。
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值