WebStorm 2025.2 Help

Dart 分析工具窗口

仅当安装并启用了 Dart 插件时,工具窗口才可用。 Dart 插件捆绑在 WebStorm 中,默认启用。 如果该插件被禁用,请在 已安装 选项卡的 设置 | 插件 页面中启用,如 管理插件 中所述。

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

消息列表

所有问题报告显示在一个表格中,该表格包含两列 描述位置 ,以及下方的摘要信息。

Dart 分析工具窗口:消息窗格
  • 描述 列显示消息内容,该内容可以是 错误消息警告提示

  • 位置 列显示以下数据:

    • 发生问题的 Dart package 名称。 Dart package 名称对应于 project name 中的 pubspec.yaml

    • 从 Dart package 根目录到出现问题文件的相对路径。

    • 出现问题的行号。

  • 工具窗口标题显示检测到的错误、警告或提示数量以及 过滤器 状态。

分组和排序

Dart 分析 工具窗口中的消息可以进行分组和排序。 默认情况下,消息按其 严重级别 优先排序,即错误消息排在列表顶部,其次是警告,最后是提示。 在每个严重级别分组中,消息按照 Dart package 名称进行分组,这对于包含多个 pubspec.yaml 文件的项目非常实用。 在每个 package 分组中,消息按文件路径进行分组。 在每个文件分组中,问题按其发生所在行号排序。

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

  • 单击 位置 列标题,以在 Dart package 名称 + 文件路径 的升序和降序排序之间切换。 请注意,这不会影响严重级别分组的顺序,即错误始终优先显示。 行号也不会被纳入排序考虑,对于每个特定文件,问题总是按行号升序显示。

  • 单击 描述 列标题,可按问题描述执行次级按字母序排序。 请注意,这不会影响按严重级别的主分组方式。

若要禁用主分组中的严重级别分组,请释放工具栏上的 按严重性分组 切换按钮 icon_run_tool_window_dart_group_by_severity.png。 之后将完全忽略问题的严重级别,仅根据其 描述位置Dart package 名称 + 文件路径 )进行排序。 此排序方式确保每个文件中的所有问题在表格中被分组在一起,不受其严重级别影响。

修复检测到的问题

您可以直接在 Dart 分析 工具窗口中修复问题。

  • 右键点击消息,并从上下文菜单中选择修复程序。

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

    选择忽略检查

    在检测到问题的行上方将添加 ignore:ignore_for_file 注释,并且错误消息将从列表中消失。

    已添加忽略注释

    如需重新启用已抑制的检查,请删除添加的注释。

工具栏按钮

工具提示与快捷键

说明

重新分析 Dart 源文件

重启 Dart 分析服务器

单击此按钮可重新启动 Dart 分析服务器,并重新分析项目的 Dart 源代码。

分析器设置

分析器设置

单击此按钮可打开 Dart 分析服务器设置 弹出窗口,其中包含以下选项:

  • 将分析范围限定为当前包

  • 打开 Dart 插件设置- 选择此选项以打开 Dart 页,在 设置 对话框中进行查看。

  • 查看分析器诊断信息- 选择此选项以打开包含分析服务器常规状态与诊断信息的页面。

单击导航

单击导航

如果按下此按钮,包含所选错误的文件将在编辑器中自动打开,光标将定位到相应的行。

按严重级别分组

按严重程度分组

  • 按下此切换按钮后,错误消息将显示在列表顶部,其次是警告,最后显示提示。 在每个严重程度组中,消息按 Dart 包名称分组,对于包含多个 pubspec.yaml 文件的项目非常实用。 在每个包组中,消息按其文件路径分组。 最后,在每个文件组中,问题按其发生的行号排序。

    您可以重新配置次级排序方式:

    • 单击 位置 列标题,可在升序与降序之间切换 Dart 包名称 + 文件路径 的排序方式。 请注意,这不会影响严重程度组的排序,即错误始终优先显示。 同样不考虑行号,对于每个具体文件,问题始终按行号升序显示。

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

  • 取消此切换按钮以禁用按严重程度的主要分组。 此后,问题的严重程度将完全不被考虑,问题报告将仅根据其 描述位置Dart 包名称 + 文件路径 )进行排序。 此排序方式可确保表格中每个特定文件的所有问题都被归为一组,无论其严重程度如何。

过滤器

过滤器

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

tool_window_dart_analysis_filter_pop_up.png
  • 严重性 区域中,指定要显示的消息类型,可用类型包括 错误警告提示。 若要显示某严重性级别的问题,请选中该级别旁的复选框。

  • 文件 区域中,选择要用于查看问题报告的作用域。 可用选项包括:

    • 整个项目

    • 当前内容根

    • 当前包: 如果选择了此选项,但没有在从当前文件起向上查找的文件夹结构中发现 pubspec.yaml 文件,则根据当前文件所在的内容根进行筛选。

    • 当前文件

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

修改当前设置后会立即应用筛选器。

上下文菜单

项目

快捷键

描述

跳转到源代码

F4

单击此按钮可跳转到引发所选问题的代码片段。

复制

Ctrl+C

将光标所在的行复制到剪贴板。

最后修改日期: 2025年 9月 26日