Java（IntelliJ中）单星号与双星号注释的区别及用途

语法与功能区别 #

• 普通多行注释（单星号开头）：格式为 /* 注释内容 */，是Java原生的基础多行注释，仅用于给开发者标注代码说明，编译时会被直接忽略，无额外结构化功能。
• 文档注释（双星号开头）：格式为 /** 注释内容 */，属于Java的Javadoc注释，是结构化注释类型，支持@param、@return、@throws等专用标签。它可通过Javadoc工具生成标准API文档，同时能被IDE识别，提供方法/类的悬浮说明、代码补全提示等实用功能。

IntelliJ中的颜色标识用途 #

IntelliJ通过颜色区分两种注释，核心是帮开发者快速识别注释类型：

• 绿色的/** ... */：标记为文档注释，IDE会解析其中的结构化标签，查看方法、类详情时会展示格式化说明，还支持一键生成Javadoc文档、静态检查注释完整性等进阶操作。
• 灰色的/* ... */：标记为普通多行注释，仅作为代码内的临时说明或补充提示，IDE不会对其做结构化解析，仅做基础的注释内容展示。

内容的提问来源于stack exchange，提问作者SomeZeplyn