PhpStorm 2025.2 Help

Dart 分析工具窗口

此工具窗口仅在安装并启用 Dart 插件时可用。 Dart 插件未与 PhpStorm 捆绑,但可以在 设置 | 插件 页面、 插件市场 选项卡上安装,如 从 JetBrains Marketplace 安装插件 中所述。

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

消息列表

所有问题报告都会显示在一个由两列组成的表格中, 描述Location ,以及下方的摘要。

Dart 分析工具窗口:消息窗格
  • 描述 列显示消息本身,可以是一个 错误消息 、一个 警告或者一个 提示

  • Location 列显示以下数据:

    • 问题出现的 Dart 包的名称。 Dart 的 package 名称对应 project name """ pubspec.yaml """

    • 从 Dart 包根目录到发生问题的文件的相对路径。

    • 问题出现的行号。

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

分组和排序

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

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

  • 单击 Location 列标题以切换 Dart package name + file path排序的升序和降序。 请注意,这不会影响严重性组的顺序,即错误总是首先显示。 行号也不会被考虑,对于每个特定文件,问题总是按行号升序显示。

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

要禁用按严重性进行的主要分组,请释放工具栏上的 按严重程度分组 toggle 按钮 icon_run_tool_window_dart_group_by_severity.png。 在那之后,问题的严重性将不再被考虑,问题报告仅按 描述Location (Dart package 名称 + 文件路径 )排序。 这种排序方法保证每个特定文件的所有问题都在表格中组合在一起,而不考虑其严重程度。

修复检测到的问题

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

  • 右键单击一条消息,然后从上下文菜单中选择一个热修复。

    选择一个热修复或抑制检查
  • 或者,选择 忽略“<inspection name>”这一行忽略 '<inspection name>' 对于此文件 来抑制检测到问题的检查,针对特定行或整个文件。

    选择忽略检查

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

    已添加忽略注释

    要重新启用被抑制的检查,请删除添加的注释。

工具栏按钮

项目

工具提示和快捷键

描述

重新分析 Dart 源代码

重启 Dart 分析服务器

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

分析器设置

分析器设置

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

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

  • 打开 Dart 插件设置 - 选择此选项以打开 设置 对话框的 Dart 页面。

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

单击导航

单击导航

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

按严重程度分组

按严重程度分组

  • 当按下此切换按钮时,错误消息显示在列表顶部,然后是警告,最后是提示。 在每个严重性组中,消息按照 Dart 包名分组,这对于多个 """ pubspec.yaml """ 文件的项目特别有用。 在每个包组中,消息按其文件路径分组。 最后,在每个文件组中,问题按发生的行号进行排序。

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

    • 单击 Location 列标题以切换 Dart package name + file path排序的升序和降序。 请注意,这不会影响严重性组的顺序,即错误总是首先显示。 行号也不会被考虑,对于每个特定文件,问题总是按行号升序显示。

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

  • 松开此切换按钮可以禁用按严重性进行的主要分组。 之后,问题的严重性将不再被考虑,问题报告将仅根据 描述Location (Dart package 名称 + 文件路径) 进行排序。 这种排序方法保证每个特定文件的所有问题都在表格中组合在一起,而不考虑其严重程度。

过滤器

过滤器

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

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

  • 个文件 区域中,选择您希望查看问题报告的范围。 可用选项包括:

    • 整个项目

    • 当前内容根目录

    • 当前包: 如果选择了此选项,但从当前文件开始的文件夹层次结构中未检测到 """ pubspec.yaml """ 文件,则根据当前文件所在的内容根目录执行筛选。

    • 当前文件

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

更改当前设置后,将立即应用过滤。

上下文菜单

项目

快捷方式

描述

跳转到源

F4

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

复制

Ctrl+C

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

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