PhpStorm 2021.3 Help

JSDoc 注释

PhpStorm 可识别JSDoc 注释,并在您键入开始块注释并按时自动插入@param@returns、和其他标记来帮助您创建它们。JSDoc 注释用于在 JavaScript 和 TypeScript 中查找文档,请参阅JavaScript 文档查找TypeScript 文档查找,以及链式方法中的类型注释方法返回类型提示@private/**EnterCtrl+Q

PhpStorm 还可以识别文档注释中的TODO 模式闭包编译器注释和TypeScript 语法,并将它们用于代码完成、意图操作和其他类型的编码辅助。

在 JSDoc入门JSDoc 支持的类型中查找 JSDoc 语法的详细说明以及示例。

创建 JSDoc 注释

  • 将插入符号放在要记录的方法/函数或字段的声明之前,键入开始块注释/**,然后按Enter

    PhpStorm 生成一个带有参数列表 ( @param) 和返回值 ( @returns) 的 JSDoc 注释(如果适用)。描述列出的参数、返回值等。

  • 或者,使用专用的Fix Doc Comment操作。将插入符号放在要记录的方法/功能或字段上,按下Ctrl+Shift+A并开始输入Fix Doc Comment。然后从列表中选择Fix Doc Comment,然后按Enter

JSDoc 注释中的 TypeScript 语法

例如,您可以在 JavaScript 文件的 JSDoc 注释中使用 TypeScript@type注释@typedef。PhpStorm 识别 TypeScript 语法结构,例如声明中的联合类型或可选属性@typedef

PhpStorm 为 TypeScript 注释提供代码完成。

JavaScript 文件中 JSDoc 中 TypeScript 注释的代码完成

基于@type注释,PhpStorm 显示参数提示。

参数提示基于 JavaScript 文件中 JSDoc 中的类型注释显示

查看编辑器中呈现的 JSDoc 注释

使用 PhpStorm,可以以更易于阅读的格式显示 JSDoc 注释。在此渲染视图模式下,项目按其@标签分组显示,而标签本身则被跳过。您可以打开引用的网页,查看引用主题的快速文档,并调整字体大小以提高可读性。

JSDoc 注释的渲染视图
  • 要进入渲染视图模式,请将鼠标指针悬停在评论上并单击切换渲染视图图标装订线或按Ctrl+Alt+Q。图标变为切换渲染视图图标

    打开渲染视图模式
  • 要退出渲染视图模式,请单击切换渲染视图图标装订线,或从 JSDoc 注释的上下文菜单中选择切换渲染视图,或按Ctrl+Alt+Q

    关闭渲染视图模式
  • 要为当前文件中的所有 JSDoc 注释打开Rendered View模式,请从装订线的上下文菜单中选择Render All Doc Comments

    渲染当前文件中的所有注释
  • 如有必要,从上下文菜单中选择调整字体大小并使用滑块更改字体大小。

    调整字体大小
  • 要显示默认呈现的所有 JSDoc 注释,请打开Settings/Preferences对话框 ( Ctrl+Alt+S),转到Editor | 一般 | Appearance,然后选中Render documentation comments复选框。

    默认开启 Rendered JSDoc comments
  • 要隐藏渲染视图装订线图标,请从装订线的上下文菜单中选择配置装订线图标,然后清除设置/首选项 |上的文档注释就地呈现复选框。编辑 | 一般 | 打开的装订线图标页面。

最后修改时间:2021 年 12 月 8 日