IDEA为类和方法设置注解模板过程
1、类方法注解模板
路径在这里:File–>settings–>Editor–>File and Code Templates–>Files
先来了解一下类注解里几个关键标签的含义:
@BelongsProject:用来标注项目名。@BelongsPackage:填写当前类的包路径。@Author:作者姓名,这个不用多说。@CreateTime:记录类的创建时间,模板会自动填充。@Description:给这个类写个简要说明,通常先写个“TODO”占位。@Version:版本号,新建类一般从1.0开始,直接写死就行。
1.1 模板
接下来,把下面这段模板代码,复制到IDEA刚才那个设置路径里。
/**
*@BelongsProject: ${PROJECT_NAME}
*@BelongsPackage: ${PACKAGE_NAME}
*@Author: zhengyuzhu
*@CreateTime: ${YEAR}-${MONTH}-${DAY} ${HOUR}:${MINUTE}
*@Description: TODO
*@Version: 1.0
*/

1.2 实际效果
光说不练假把式,新建一个类试试看效果。
/**
* @BelongsProject: Ja va-Work-Demo
* @BelongsPackage: A1多线程.B1超时处理.Demo1
* @Author: zhengyuzhu
* @CreateTime: 2023-11-14 11:31
* @Description: TODO
* @Version: 1.0
*/
public class MyTest {
}
2、方法注解模板(一)
1.1 模板
类模板搞定了,方法模板也不能少。第一种是参数和返回值分开显示的格式,模板如下:
* * @description: * @author: zhengyuzhu * @date: $date$ $time$ * @param: $param$ * @return: $return$ **/
这个模板最终生成的效果是这样的:

具体怎么设置呢?跟着下面这几步走:




这里有个关键点:操作顺序千万别搞错。否则,函数参数可能读取不到。


1.2 实际效果
设置完成后,在方法上输入“/**”然后回车,就能看到自动生成的注解了。
/**
* @description:
* @author: zhengyuzhu
* @date: 2023/11/14 12:21
* @param: [a, str]
* @return: void
**/
public void Test(int a, String str){
}
/**
* @description:
* @author: zhengyuzhu
* @date: 2023/11/14 12:22
* @param: []
* @return: ja va.util.List
**/
public List Test2(){
ArrayList
3、方法注解模板(二)
1.1 模板
如果你觉得第一种模板的格式不够紧凑,可以试试第二种。这种模板把参数和返回值信息都放在`@date`标签后面,看起来更简洁。
* * @description: * @author: zhengyuzhu * @date: $date$ $time$ $param$ $return$ **/
先看看效果:

设置过程和第一种模板大同小异,主要是模板内容和“获取方法”的表达式需要调整。
具体步骤参考下图:


核心在这里:自定义“获取方法”表达式。你需要将下面几段Groovy脚本分别填入对应的位置。
1. 用于获取参数的自定义方法:
groovyScript("def result = '';def params = \"${_1}\".replaceAll('[\\\\[|\\\\]|\\\\s]', '').split(',').toList(); for(i = 0; i < params.size(); i++) {if(params[i] != '')result+='* @param: ' + params[i] + ((i < params.size() - 1) ? '\\r\\n ' : '')}; return result == '' ? null : '\\r\\n ' + result", methodParameters())
2. 用于获取返回值(包含完整包名)的自定义方法:
groovyScript("return \"${_1}\" == 'void' ? null : '\\r\\n * @return: ' + \"${_1}\"", methodReturnType())
3. 用于获取返回值(不包含包名,只取类名)的自定义方法:
groovyScript("def result=''; def params=\"${_1}\".replaceAll('[\\\\[|\\\\]|\\\\s]', '').split('<').toList(); for(i = 0; i < params.size(); i++) {if(i!=0){result+='<';}; def p1=params[i].split(',').toList(); for(i2 = 0; i2 < p1.size(); i2++) { def p2=p1[i2].split('\\\\.').toList(); result+=p2[p2.size()-1]; if(i2!=p1.size()-1){result+=','} } ; }; return result", methodReturnType())
1.2 实际效果
我个人更习惯显示完整的包名,这样追溯起来更清晰。当然,你可以根据喜好选择。来看看生成的效果:
/**
* @description:
* @author: zhengyuzhu
* @date: 2023/11/14 12:34
* @param: a
* @param: b
* @param: c
* @return: ja va.lang.String
**/
public String TestDemo(int a,String b,List c){
return null;
}
/**
* @description:
* @author: zhengyuzhu
* @date: 2023/11/14 12:41
* @param: a
* @param: b
* @return: ja va.util.List
**/
public List list (int a ,String b){
return null;
}
总结
好了,以上就是关于IDEA中自定义类和方法注解模板的详细配置过程。两种方法模板各有特点,第一种条理清晰,第二种紧凑高效,选择哪种全看你的编码习惯。希望这份经验能帮你提升开发效率,让代码注释更加规范美观。
您可能感兴趣的文章:
- IDEA 自定义方法注解模板的实现方法
- 详解IntelliJ IDEA 自定义方法注解模板
游乐网为非赢利性网站,所展示的游戏/软件/文章内容均来自于互联网或第三方用户上传分享,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系youleyoucom@outlook.com。
同类文章
centos上golang打包的文件如何分发
在CentOS上使用Golang打包的应用程序可以通过以下步骤进行分发 把Golang应用从开发环境搬到生产服务器,这事儿说简单也简单,但想做得规范、可靠,还真有几个关键步骤得走对。下面这份操作指南,能帮你把打包好的程序稳稳当当地部署到CentOS系统上。 1 打包应用程序 首先,在你的CentO
centos上golang打包后的文件在哪
在 CentOS 上定位 Go 语言编译后的可执行文件 在 CentOS 系统上使用 Go 语言完成编译打包后,生成的可执行文件到底藏在哪里?这是很多开发者,尤其是刚接触 Go 的新手,会遇到的第一个实操问题。其实,答案比你想象的要直接。 简单来说,如果你没有特别指定输出路径,这个文件通常就安静地躺
如何在CentOS设置Golang日志
在CentOS上为Golang应用配置日志:一份实操指南 为运行在CentOS服务器上的Golang应用程序建立一个可靠的日志系统,是确保应用可观测性和后期排障的基础。下面这份分步指南,将带你完成从环境准备到日志落地的全过程。 第一步:安装Golang运行环境 如果系统尚未安装Golang,需要先进
如何自动化处理CentOS PHP日志
自动化处理 CentOS PHP 日志的实用方案 让系统日志管理自动化,是提升运维效率的关键一步。针对 CentOS 上的 PHP 日志,通常可以通过组合系统工具与自定义脚本的方式来实现。下面介绍两种核心方法,你可以根据实际场景灵活选用或结合。 1 使用 logrotate 工具进行日志轮转 首先
CentOS Golang日志如何归档
在 CentOS 上实现 Golang 日志归档的几种实用方法 对于在 CentOS 上运行的 Golang 应用来说,日志管理是个绕不开的话题。尤其是日志归档,直接关系到后续的问题排查和系统审计。那么,具体有哪些行之有效的方案呢?其实主要可以从系统工具、代码层面和服务管理三个方向入手。 1 使用
- 日榜
- 周榜
- 月榜
1
2
3
4
5
6
7
8
9
10
相关攻略
2015-03-10 11:25
2015-03-10 11:05
2021-08-04 13:30
2015-03-10 11:22
2015-03-10 12:39
2022-05-16 18:57
2025-05-23 13:43
2025-05-23 14:01
热门教程
- 游戏攻略
- 安卓教程
- 苹果教程
- 电脑教程
热门话题

