IDEA注释模板设置教程

本文详细讲解了在 IntelliJ IDEA 中正确设置类头注释模板的完整方法，重点厘清了常被混淆的 File and Code Templates（用于新建文件时自动生成注释）与 Live Templates 的本质区别，手把手指导用户通过 Settings > Editor > File and Code Templates > Files 路径精准修改 Class、Interface 等模板，并灵活运用 ${USER}、${DATE}、${TIME}、${PACKAGE_NAME}、${NAME} 等预定义变量实现自动化、个性化注释；同时预警了插件冲突、模板误选、Kotlin/Java 模板混用、Lombok 兼容性及 Git 用户信息无法原生获取等高频踩坑点，帮你彻底告别“改了没生效”的困扰，让每一行代码从诞生起就自带规范、可追溯、不重复劳动。

IDEA 类头注释模板在哪改

在 File and Code Templates 里改，不是在 Live Templates 或 Editor > Inspections 里。很多人找错位置，结果改了半天没生效。

路径是：Settings > Editor > File and Code Templates > Files，找到你用的类模板，比如 Class、Interface 或 Enum —— 这些才是生成新类时套用的模板。

• 改的是「新建文件」时自动生成的内容，不是已有文件补注释
• Includes 标签页里的 File Header 是全局文件头（比如版权说明），它会被插入到每个模板开头，但不替代类模板自身内容
• 如果用了 Lombok 的 @Data 等注解，模板里别硬写 get/set 方法，容易和实际生成冲突

怎么写带作者/日期的类头注释

IDEA 支持预定义变量，直接填进模板就行，不用手写或脚本拼接。关键是要用对变量名，否则显示成字面量。

常用变量：

• ${USER}：系统用户名（可手动设为中文名，在 Settings > Appearance & Behavior > System Settings > User name）
• ${DATE}：生成当天日期，格式如 2024/06/12
• ${TIME}：生成时间，如 15:23
• ${YEAR}：四位年份
• ${PACKAGE_NAME}：自动识别当前包路径
• ${NAME}：新文件名（不含扩展名），也就是类名

示例（粘贴到 Class 模板中）：

/**
 * @author ${USER}
 * @date ${DATE} ${TIME}
 * @package ${PACKAGE_NAME}
 * @className ${NAME}
 */

为什么改完模板新建类还是没注释

最常见原因是模板没选对，或者被其他插件覆盖。

• 确认你在改的是 Files 标签页下的 Class，不是 Code 标签页下的任何内容
• 检查是否勾选了 Enable Live Templates 并误启用了某个同名模板（比如叫 class 的 Live Template），它会劫持新建行为
• 如果用的是 Kotlin，要改 Kotlin Class 模板，Java 的 Class 模板对它无效
• 某些公司内部插件（如 Alibaba Java Coding Guidelines）会自带模板逻辑，优先级可能更高，得关掉或调低权重

注释里想加 Git 用户信息怎么办

IDEA 原生不支持 ${GIT_AUTHOR} 这类变量，硬写只会原样输出。真要动态取 Git 配置，得绕路。

• 可以手动在 Settings > Version Control > Git 里核对 Author name 和 Email 是否正确，然后用 ${USER} 代替——前提是本地 Git 用户名和系统用户名一致
• 不想依赖系统名？只能写死，比如 @author 张三 ，但失去自动化意义
• 更灵活的做法是配合 IDE 插件（如 “Template Data Language”），但会引入额外维护成本，小团队不建议

变量不是万能的，${USER} 是最稳的选择；想自动读 Git 配置，就得接受 IDE 不原生支持这个场景。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~