JSRUN 用代码说话

创建文档注释

编辑教程

创建文档注释

请注意:本节引用了 JavaScript、Java、Python 和其他具有特殊文档注释开头的语言。本节不引用 Ruby。

IntelliJ IDEA 可以使用专用的操作创建文档注释和修复文档注释,可以通过 "查找操作" 命令调用它。

按 Ctrl+Shift+A,将插入符号放在类、方法、函数或字段中的某个位置,字符应被记录,并输入操作名称修复文档字符串。添加了相应标签的缺少文档存根。例如:

/**
*
* @param userInput
* @return
*/
static boolean processRepeatConversion (@NotNull String userInput) {
boolean repeatConversion = false;
if (((userInput.equals("y")) || (userInput.equals("Y")))) {
repeatConversion = true;
}
return repeatConversion;

}

IntelliJ IDEA 修复文档注释

接下来的示例说明了现有文档注释中的修复问题。

下一个案例在现有文件评论中出现了修复问题。

例如,如果方法签名已更改,IntelliJ IDEA 将突出显示与方法签名不匹配的标记,并建议快速修复。

tip:修复文档注释的操作没有键盘快捷键,但是您可以配置你自己的键盘快捷方式。

对于 JavaScript,IntelliJ IDEA 建议一个意图行为 UpdateJSDoc 评论。您也可以按 Ctrl+Shift+A,然后键入操作名称:

IntelliJ IDEA 修复文档注释

IntelliJ IDEA 为方法和函数创建文档注释

在 IntelliJ IDEA 中可以为方法或函数创建文档注释,具体的操作步骤如下所述:

在声明前放置插入符号。
键入开启块注释/**,然后按 Enter 键。
添加有意义的参数描述和返回值。

在您使用 IntelliJ IDEA 为方法和函数创建文档注释的时候,请您注意以下事项:

IntelliJ IDEA 会检查文档注释中的语法,并根据错误设置对其进行处理。
如果输入的文本包含 HTML 标签,则在键入 > 后将自动添加结束标签,前提是在编辑器设置中启用了此行为。
当在输入文档注释时,插入符号会自动移动到预期的位置。例如:

IntelliJ IDEA 为方法和函数创建文档注释

IntelliJ IDEA 在文档注释块中创建标签

在注释块中,选择所需的空行和输入@或 character (对于 Python 和 Ruby 语言)。
按 Ctrl+Space,或者只是等待代码完成显示建议列表:

IntelliJ IDEA 在文档注释块中创建标签

  1. 从建议列表中选择一个标签。例如,您可以指定参数类型或返回类型。
  2. 如果某个标签有多个值,请在标签后按 Ctrl+Space ,然后从建议列表中选择所需的值。例如,IntelliJ IDEA 建议选择所需的参数名称。

IntelliJ IDEA 在文档注释块中创建标签

注意:以下仅在安装并启用 Ruby Plugin 时有效!

IntelliJ IDEA 为 Ruby 方法创建文档注释

将插入符号放在要记录的方法声明之前的空行上
键入文档注释的开头(#),或者只是按 Ctrl+Slash。
按 Ctrl+Space,并从建议列表中选择所需的标签。然后再次按 Ctrl+Space,然后选择所需的参数名称:

IntelliJ IDEA 为 Ruby 方法创建文档注释

要使用意图行为为 Ruby 方法创建文档注释,请执行以下操作之一:

  • 将插入符放在要记录的方法中的任何位置,按下 Alt+Enter 并选择 "添加 @return 标记"。将创建带有 @return 标记的文档注释。指定返回类型:

IntelliJ IDEA 为 Ruby 方法创建文档注释

  • 将插入符号放在要记录的参数上,按 Alt+Enter,然后选择 "添加 @param 标签"。将创建带有所选参数的 @param 标签的文档注释。指定参数类型:

以下仅在安装并启用 Python Plugin 时有效!

IntelliJ IDEA 为 Python 函数创建文档注释

您需要注意以下几点:

当在编辑器设置页面的智能键页面中清除了“插入引号对”复选框时,如果按下 Space 键生成的文档字符串会有打开三重引号。
如果重命名一个函数的参数,IntelliJ IDEA 将相应地更新文档注释中的标记。

为 Python 函数创建文档注释的操作步骤如下:

将插入符号放在要记录的函数声明之后。
键入 "打开三重号",然后按 Enter,或 Space。
添加有意义的参数描述和返回值。

使用意图行为为 Python 函数创建文档注释的步骤:

将插入符号放在要记录的函数中的某个位置。

按 Alt+Enter 显示可用的意图行为。

选择插入文档字符串存根:

IntelliJ IDEA 为 Python 函数创建文档注释

IntelliJ IDEA 根据 文档字符串格式生成文档注释存根,在 Python 集成工具页面中选择。

使用 Python 注释的例子:

考虑以下功能:

def handle(self, myParam1, myParam2):

在 "Python 集成工具" 页中,选择 "Epytext"。然后键入打开的三重引号,然后按 Enter 或 Space。IntelliJ IDEA 生成文档注释存根:

'''
@param self:
@param myParam1:
@param myParam2:
@return:
'''

然后选择 reStructuredText,键入打开的三重引号,然后按 Enter 或 Space。IntelliJ IDEA 生成文档注释存根:

'''
:param self:
:param myParam1:
:param myParam2:
:return:
'''

IntelliJ IDEA 填充段落

Java 注释 支持“填充段落”操作。此操作会在注释中创建软包装。要使用此操作,请按照下列步骤操作:

将插入符号放在类中的某个注释内。

执行以下操作之一:

在主菜单上选择编辑丨填充段落。
按下 Ctrl+Shift+A,在弹出框中,键入填充段落,然后按 Enter 键。

IntelliJ IDEA 中可点击的注释

如果文档注释包含超链接,您可以使其可点击。

要做到这一点,请执行以下操作之一:

按住 Ctrl 键并将鼠标指针悬停在超链接上:

IntelliJ IDEA 中可点击的注释

按 Ctrl+B。

JSRUN闪电教程系统是国内最先开创的教程维护系统, 所有工程师都可以参与共同维护的闪电教程,让知识的积累变得统一完整、自成体系。 大家可以一起参与进共编,让零散的知识点帮助更多的人。
X
支付宝
9.99
无法付款,请点击这里
金额: 0
备注:
转账时请填写正确的金额和备注信息,到账由人工处理,可能需要较长时间
如有疑问请联系QQ:565830900
正在生成二维码, 此过程可能需要15秒钟