《IDEA 高效开发:自定义类/方法注释模板详解》

在 IntelliJ IDEA 中,可以通过 Live TemplatesFile Templates 来配置 类注释方法注释 模板,方便快速生成规范的代码注释。以下是详细配置方法:


1. 配置类注释模板(File Header)

作用 :在创建新类时自动生成类注释(如作者、日期、描述等)。
配置步骤

  1. 打开设置
    FileSettingsEditorFile and Code TemplatesIncludesFile Header

  2. 输入模板(示例):

    java 复制代码
    /**
     * @ClassName ${NAME}
     * @Description ${DESCRIPTION}
     * @Author ${USER}
     * @Date ${DATE} ${TIME}
     * @Version 1.0
     */
  3. 变量说明

    • ${NAME}:类名
    • ${USER}:当前系统用户名
    • ${DATE}${TIME}:当前日期和时间
    • ${DESCRIPTION}:类描述(需手动填写)
  4. 应用:创建新类时,IDEA 会自动插入该注释。


2. 配置方法注释模板(Live Templates)

作用 :输入快捷键(如 /** + Enter)自动生成方法注释。
配置步骤

  1. 打开设置
    FileSettingsEditorLive Templates

  2. 新建模板组(可选):

    • 点击 +Template Group,命名为 MyTemplates
  3. 新建模板

    • 点击 +Live Template

    • Abbreviation(缩写) :输入 /**mc(自定义快捷键)。

    • Template text(模板内容)

      java 复制代码
      /**
       * @Description $description$
       * @Param $params$
       * @Return $return$
       * @Author $user$
       * @Date $date$ $time$
       */
  4. 变量配置

    • 点击 Edit variables,设置变量值:
      • descriptionmethodName()(或手动填写)
      • paramsmethodParameters()
      • returnmethodReturnType()
      • useruser()
      • datedate()
      • timetime()
  5. 适用范围

    • 勾选 JavaDeclaration(确保在方法上生效)。
  6. 应用 :在方法前输入 /** 并按 TabEnter,自动生成注释。


3. 示例效果

类注释

java 复制代码
/**
 * @ClassName UserService
 * @Description 用户服务类
 * @Author ZhangSan
 * @Date 2023-10-01 14:30
 * @Version 1.0
 */
public class UserService {
    // ...
}

方法注释

java 复制代码
/**
 * @Description 根据ID查询用户
 * @Param id 用户ID
 * @Return User 用户对象
 * @Author ZhangSan
 * @Date 2023-10-01 14:35
 */
public User getUserById(Long id) {
    // ...
}

4. 高级配置(可选)

  • 自定义日期格式
    File HeaderLive Templates 中使用 $DATE.format("yyyy-MM-dd")$
  • 公司/项目统一模板
    通过 Export/Import Settings 导出模板,团队共享。
相关推荐
TT哇21 分钟前
【Java EE初阶】计算机是如何⼯作的
java·redis·java-ee
SunTecTec25 分钟前
【阿里巴巴JAVA开发手册】IDE的text file encoding设置为UTF-8; IDE中文件的换行符使用Unix格式,不要使用Windows格式。
intellij-idea·seatunnel
Fireworkitte7 小时前
Apache POI 详解 - Java 操作 Excel/Word/PPT
java·apache·excel
weixin-a153003083167 小时前
【playwright篇】教程(十七)[html元素知识]
java·前端·html
DCTANT7 小时前
【原创】国产化适配-全量迁移MySQL数据到OpenGauss数据库
java·数据库·spring boot·mysql·opengauss
Touper.8 小时前
SpringBoot -- 自动配置原理
java·spring boot·后端
黄雪超8 小时前
JVM——函数式语法糖:如何使用Function、Stream来编写函数式程序?
java·开发语言·jvm
ThetaarSofVenice8 小时前
对象的finalization机制Test
java·开发语言·jvm
望获linux9 小时前
【实时Linux实战系列】CPU 隔离与屏蔽技术
java·linux·运维·服务器·操作系统·开源软件·嵌入式软件
JosieBook9 小时前
【Java编程动手学】使用IDEA创建第一个HelloJava程序
java·开发语言·intellij-idea