Dart 分析工具窗口
仅当安装并启用了 Dart 插件时,工具窗口才可用。 Dart 插件捆绑在 WebStorm 中,默认启用。 如果该插件被禁用,请在 已安装 选项卡的 设置 | 插件 页面中启用,如 管理插件 中所述。
WebStorm 集成了 Dart Analyzer tool ,该工具可对 Dart 源代码执行静态分析。 所有不一致项和潜在问题都会在 Dart 分析 工具窗口中报告,并可跳转到检测到问题的源代码片段。
消息列表
所有问题报告显示在一个表格中,该表格包含两列 描述 与 位置 ,以及下方的摘要信息。

描述 列显示消息内容,该内容可以是 错误消息、 警告 或 提示。
位置 列显示以下数据:
发生问题的 Dart package 名称。 Dart package 名称对应于
project name中的 pubspec.yaml 。从 Dart package 根目录到出现问题文件的相对路径。
出现问题的行号。
工具窗口标题显示检测到的错误、警告或提示数量以及 过滤器 状态。
分组和排序
Dart 分析 工具窗口中的消息可以进行分组和排序。 默认情况下,消息按其 严重级别 优先排序,即错误消息排在列表顶部,其次是警告,最后是提示。 在每个严重级别分组中,消息按照 Dart package 名称进行分组,这对于包含多个 pubspec.yaml 文件的项目非常实用。 在每个 package 分组中,消息按文件路径进行分组。 在每个文件分组中,问题按其发生所在行号排序。
您可以重新配置次级排序:
单击 位置 列标题,以在 Dart package 名称 + 文件路径 的升序和降序排序之间切换。 请注意,这不会影响严重级别分组的顺序,即错误始终优先显示。 行号也不会被纳入排序考虑,对于每个特定文件,问题总是按行号升序显示。
单击 描述 列标题,可按问题描述执行次级按字母序排序。 请注意,这不会影响按严重级别的主分组方式。
若要禁用主分组中的严重级别分组,请释放工具栏上的 按严重性分组 切换按钮
。 之后将完全忽略问题的严重级别,仅根据其 描述 或 位置 (Dart package 名称 + 文件路径 )进行排序。 此排序方式确保每个文件中的所有问题在表格中被分组在一起,不受其严重级别影响。
修复检测到的问题
您可以直接在 Dart 分析 工具窗口中修复问题。
右键点击消息,并从上下文菜单中选择修复程序。

或者,选择 忽略该行的 '<inspection name>' 或 忽略该文件的 '<inspection name>' ,以抑制该检查在特定行或整个文件中的检测。

在检测到问题的行上方将添加
ignore:或ignore_for_file注释,并且错误消息将从列表中消失。
如需重新启用已抑制的检查,请删除添加的注释。
工具栏按钮
项 | 工具提示与快捷键 | 说明 |
|---|---|---|
重启 Dart 分析服务器 | 单击此按钮可重新启动 Dart 分析服务器,并重新分析项目的 Dart 源代码。 | |
分析器设置 | 单击此按钮可打开 Dart 分析服务器设置 弹出窗口,其中包含以下选项: | |
单击导航 | 如果按下此按钮,包含所选错误的文件将在编辑器中自动打开,光标将定位到相应的行。 | |
按严重程度分组 |
| |
过滤器 | 单击此按钮可打开 Dart 问题筛选器 弹出窗口,您可以在其中配置是否在工具窗口中显示问题报告的筛选条件。 ![]()
修改当前设置后会立即应用筛选器。 |
上下文菜单
项目 | 快捷键 | 描述 |
|---|---|---|
跳转到源代码 | F4 | 单击此按钮可跳转到引发所选问题的代码片段。 |
复制 | Ctrl+C | 将光标所在的行复制到剪贴板。 |
