一、快捷键
Idea提供了多种方式来快速添加方法注释，其中最常用的是快捷键。在方法名所在行上按下"Ctrl+Shift+/"，即可自动生成方法注释模板。
/**
*
*/
同时，Idea还提供了一个更加快速的方法注释快捷键，即"Ctrl+Alt+T"，通过该快捷键可以直接调出方法注释模板对话框，快速添加方法注释。
二、显示方法注释
在Idea中，除了使用方法注释快捷键直接生成注释模板外，还可以查看已有方法注释内容。鼠标悬停在方法名上时，会弹出包含方法注释的提示框。
/**
* 该方法用于求两个数的和
* @param a 第一个数
* @param b 第二个数
* @return 返回两数之和
*/
public int add(int a, int b) {
return a + b;
}
三、方法注释模板设置
对于Idea来说，方法注释模板是可以自定义的。可以在Idea的设置中进行配置。
1. 在Idea中选择"File" -> "Settings"，打开设置页面。
2. 选择"Editor" -> "File and Code Templates"。
3. 在Code Templates页面，选择"Include"标签页，可以看到"Java Method Body"选项。
4. 点击"Edit"按钮，可以修改Java方法注释的模板，例如：
/**
* ${DESCRIPTION}
* @param ${PARAMETER_NAME} ${PARAMETER_DESCRIPTION}
* @return ${RETURN_TYPE_DESCRIPTION}
*/
四、方法注释模板参数多行
在使用Idea添加方法注释时，可以添加多行的参数描述。可以通过修改模板实现多行参数。
/**
* ${DESCRIPTION}
* @param ${PARAMETER_NAME}
* ${PARAMETER_DESCRIPTION_LINE1}
* ${PARAMETER_DESCRIPTION_LINE2}
* @return ${RETURN_TYPE_DESCRIPTION}
*/
五、注释模板
除了方法注释外，Idea还支持其他类型的注释，如类注释、变量注释等。可以通过设置来自定义模板。
1. 在Idea中选择"File" -> "Settings"，打开设置页面。
2. 选择"Editor" -> "File and Code Templates"。
3. 在Code Templates页面，选择"Includes"标签页，可以看到多个选项。
4. 选择需要配置的模板，例如"Class"。
5. 点击"Edit"按钮，就可以编辑该类型注释的模板。
/**
* ${DESCRIPTION}
*
* @author ${USER}
* @date ${DATE}${TIME}
*/
六、设置类注释和方法注释
在Idea中配置类注释和方法注释模板非常简单，在"Settings"-> "Editor" -> "Code Style" -> "Java" -> "Code Generation"中设置即可。可以修改注释模板、位置、空行等设置。
/**
* ${DESCRIPTION}
*
* @since ${DATE}${TIME}
* @version 1.0
*/
七、配置注释模板
在Idea中，可以很方便地配置注释模板。通过修改模板，可以快速生成符合规范的方法和类注释。
1. 打开Idea设置页面。
2. 选择"Editor" -> "File and Code Templates"，可以看到多个选项。
3. 选择"Default Templates" -> "Java Class" -> "Class"，编辑类注释的模板。
4. 选择"Default Templates" -> "Java Class" -> "Method", 编辑方法注释的模板。
/**
* ${NAME}
* This is a class
* @version 1.0.0
* @author ${USER}
* @since ${DATE} ${TIME}
*/
/**
* ${DESCRIPTION}
* 类名：${CLASS_NAME}
* 方法名：${METHOD_NAME}
* @param ${PARAMETER} ${PARAMETER_DESCRIPTION}
* @return ${RETURN_DESCRIPTION}
* @throws ${THROWABLE_DESCRIPTION}
*/
八、方法注释获取异常
在Idea中，生成方法注释时，可能会出现无法获取异常等问题。这时可以检查以下配置：
1. 检查是否设置了JDK或Idea SDK，如果没有设置请在"File -> Project Structure -> SDKs"中设置。
2. 检查当前的Project Settings -> Modules -> Sources是否已经标记为Sources路径。
3. 检查当前的Source Folder路径下是否存在.class文件或漏掉了.java文件。
九、方法注释展开选取
如果要对一个已经存在的方法进行注释，可以选择该方法名，按下"Ctrl+Shift+/"快捷键，即可展开已有注释模板，然后根据具体情况修改模板内容即可。
以上就是关于Idea方法注释的详细阐述，使用Idea添加方法注释可以提高代码的可读性和可维护性，大大方便了代码阅读和维护。
