IDEA设置JAVA类和方法自定义注释模板方法

目录

一、类注释

二、方法注释

1 创建分组 Template Group

2 在分组里创建一个 Live Template 模版

3 配置 Live Template 模版

3.1 配置Abbreviation Description

3.2 配置Template text

3.3 配置Edit variables

3.4 配置 Options

3.5 配置模版应用范围


一、类注释

在IDEA中打开File-Settings,在Settings中打开Editor-File and Code Templates,在左边的Files中选中Class

如上图,Class编辑框中,编写如下代码:

/**
 * @description: 
 * @author: liuyandeng
 * @date: ${DATE}
 */

上述代码在创建类时生成效果如下:

/**
 * @description: 
 * @author: liuyandeng
 * @date: 2024/12/30
 */

其他参数

${NAME}:设置类名
${USER}、${DATE}、${TIME}:设置创建类的用户、创建的日期和时间,还有一些其他的方法,比如:
项目名:${PROJECT_NAME},
日期格式:${YEAR}年${MONTH}月${DAY}日 ${HOUR}:${MINUTE}:${SECOND}

二、方法注释

Settings中打开Editor-Live Templates,如下图:

1 创建分组 Template Group

点击 " + " 号,选择Template Group,接着在弹出框中设置好这个组的名字,点击确定,例如:userDefine

2 在分组里创建一个 Live Template 模版

选中上面我们刚刚创建的分组userDefine,然后点击 " + " 号,选择Live Template

3 配置 Live Template 模版

3.1 配置Abbreviation Description

上图中Abbreviation设置项 ,是在我们要生成注释时,选择自己的某一个Live Template模版的快捷提示。IDEA生成注释的方式是:模板名+快捷键(比如设置模板名为a,快捷键用Tab,则生成方式为a+Enter),可以根据这个来选择使用不同的模版注释。不要把Abbreviation设置成斜杠,因为这会导致注释无法获取方法参数。设置成其他的字母或是符号都可以&

### 配置 IntelliJ IDEA 中的 Java 方法注释模板 #### 创建自定义活码模板 (Live Templates) 为了在 IntelliJ IDEA配置 Java 方法注释模板,需通过创建自定义活码模板来实现。这可以通过进入设置菜单完成。 对于 Windows 用户,在 IDEA 主界面按下 `Ctrl + Alt + S` 打开设置窗口;而对于 Mac 用户,则可以使用快捷键 `Command + ,` 来访问相同的功能[^3]。 一旦进入了设置页面,导航至 `Editor -> Live Templates` 路径下。在此处能够看到多个预设好的代码片段以及用户自行添加的新条目。要新增一个用于自动填充注释的模板,点击右侧面板上的绿色加号按钮并选择 "Live Template"。 #### 定义具体的方法注释模板 当选择了 "Live Template" 后,会弹出一个新的对话框让用户填写必要的细节: - **Abbreviation**: 输入触发该模板时使用的缩写词,例如为方法注释设定为 `meth` 或者针对整个则可能是 `cls`。 - **Description**: 描述此模板的作用范围及其功能简介。 - **Template text**: 编辑实际想要插入到源文件里的文本内容。这里可以根据个人喜好调整格式化风格,并利用特殊占位符(如 `$PARAMETERS$`, `$RETURN_TYPE$` 等)来自动生成参数列表或其他上下文敏感的信息[^4]。 下面是一个简单的例子展示如何编写适用于大多数情况下的方法注释模板: ```text /** * ${DESCRIPTION} * * @param ${parameters} * @return ${returnType} */ ``` 其中 `${parameters}` 变量可通过 Groovy 表达式动态计算得出所有形参的名字与型组合而成的一串字符串。 同样地,如果希望给每一个新建立的 Java 都附带标准形式的头部说明文字,也可以按照上述流程操作一遍,只是这次应该把重点放在描述的目的、作者姓名以及其他元数据上。 #### 应用场景示例 假设现在有一个名为 `CalculatorService` 的服务层接口里包含了两个业务逻辑函数——一个是用来求两数之差 (`subtract`),另一个则是获取当前时间戳(`getCurrentTimestamp`)。那么借助于之前所定制过的 live template 就可以在 IDE 提示下快速写出如下所示的标准 Javadoc 形式的文档结构: ```java public interface CalculatorService { /** * 计算两个整数之间的差异. * * @param minuend 减数 * @param subtrahend 被减数 * @return 差值 */ int subtract(int minuend, int subtrahend); /** * 获取系统当前的时间戳毫秒表示法. * * @return 时间戳数值 */ long getCurrentTimestamp(); } ```
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

晨港飞燕刘彦登

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值