WebStorm 2021.1 Help

Dart 分析工具窗口

只有在安装并启用了Dart插件后,该工具窗口才可用。Dart插件与WebStorm捆绑在一起并默认激活。如果插件被禁用,请在设置/首选项的已安装选项卡上启用它。插件页面,如管理插件中所述。

WebStorm 与Dart Analyzer 工具集成,该工具对您的 Dart 源代码执行静态分析。所有不一致和潜在问题都会在Dart 分析工具窗口中报告,并可以导航到检测到问题的源代码片段。

消息列表

所有问题报告都显示在一个表格中,该表格由两列DescriptionLocation以及下面的摘要组成。

Dart 分析工具窗口:消息窗格
  • Description列显示消息本身,可以是错误消息警告提示

  • 位置列显示以下数据:

    • 出现问题的 Dart 包的名称。Dart 包名称对应于project name来自pubspec.yaml

    • 从 Dart 包根到出现问题的文件的相对关系。

    • 出现问题的行号。

  • 表格下方的摘要区域显示检测到的错误、警告或提示的数量以及过滤器状态。

分组和排序

Dart 分析工具窗口中的消息可以进行分组和排序。默认情况下,消息主要按严重性排序,即错误消息显示在列表顶部,然后是警告,最后显示提示。在每个严重性组中,消息按 Dart 包名称分组,这对于具有多个pubspec.yaml文件的项目非常方便。在每个包组中,消息按其文件路径分组。最后,在每个文件组中,问题按出现的行号排序。

您可以重新配置二级排序:

  • 单击Location列标题,可以在Dart 包名 + 文件路径排序的升序和降序之间切换。请注意,这不会影响严重性组的顺序,即始终首先显示错误。也不考虑行号,因为每个特定的文件问题总是以行号的升序显示。

  • 单击描述列标题以按问题描述的字母顺序执行二次排序。请注意,这不会影响按严重性进行的主要分组。

要禁用按严重性进行的主要分组,请释放工具栏上的“按严重性分组”切换按钮icon_run_tool_window_dart_group_by_severity.png。之后根本不考虑问题的严重性,问题报告仅按其描述位置Dart 包名称 + 文件路径)排序。这种排序方法保证每个特定文件的所有问题都在表中分组在一起,无论其严重程度如何。

工具栏按钮

物品

工具提示和快捷方式

描述

重新分析 Dart 来源

重新分析 Dart 来源

单击此按钮可在不停止 Dart 分析服务器的情况下运行项目的 Dart 源代码分析。

重启 Dart 分析服务器

重启 Dart 分析服务器

单击此按钮可终止 Dart 分析服务器,然后启动它。

一键导航

一键导航

如果按下此按钮,包含所选错误的文件将在编辑器中自动打开,插入符号位于相应的行。

按严重性分组

按严重性分组

  • 按下此切换按钮时,错误消息显示在列表顶部,然后是警告,最后显示提示。在每个严重性组中,消息按 Dart 包名称分组,这对于具有多个pubspec.yaml文件的项目非常方便。在每个包组中,消息按其文件路径分组。最后,在每个文件组中,问题按出现的行号排序。

    您可以重新配置二级排序:

    • 单击Location列标题,可以在Dart 包名 + 文件路径排序的升序和降序之间切换。请注意,这不会影响严重性组的顺序,即始终首先显示错误。也不考虑行号,因为每个特定的文件问题总是以行号的升序显示。

    • 单击描述列标题以按问题描述的字母顺序执行二次排序。请注意,这不会影响按严重性进行的主要分组。

  • 释放此切换按钮可禁用按严重性进行的主要分组。之后根本不考虑问题的严重性,问题报告仅按其描述位置Dart 包名称 + 文件路径)排序。这种排序方法保证每个特定文件的所有问题都在表中分组在一起,无论其严重程度如何。

筛选

筛选

单击此按钮打开Dart 问题过滤器弹出窗口,您可以在其中配置问题报告是否显示在工具窗口中的条件。

tool_window_dart_analysis_filter_pop_up.png
  • Severity区域中,指定要显示的消息类型,可用类型为ErrorsWarningsHints。要显示严重级别的问题,请选中此严重级别旁边的复选框。

  • 文件区域中,选择您要查看问题报告的范围。可用的选项有:

    • 整个项目

    • 当前内容根

    • 当前包:选择此选项但未从当前文件启动的文件夹层次结构时检测到pubspec.yaml文件,然后根据当前文件所在的内容root来执行过滤。

    • 当前文件

  • 单击重置所有过滤器链接以恢复默认过滤器设置。

只要您更改当前设置,就会立即应用过滤。

上下文菜单

物品

捷径

描述

跳转到源

F4

单击此按钮可导航到导致所选问题的代码片段。

复制

Ctrl+C

将插入符号处的行移至剪贴板。

最后修改:2021 年 9 月 23 日