WebStorm 2025.2 Help

运行检查

WebStorm 在编辑器中打开的文件中分析代码 ,并在输入时高亮显示存在问题的代码。 此外,您还可以在选定文件范围内 手动运行所需检查或一组检查。 在这种情况下,您将获得文件中检测到的所有问题的全面报告。

当前文件的即时分析

IDE 持续检查您的代码并查找问题。 编辑器右上角的小部件显示在当前文件中检测到的各个 严重性的问题数量:

检查小部件

单击该小部件可在 文件 选项卡中打开 “问题”工具窗口中的问题列表。 您还可以通过选择 问题 或按下 视图 | 工具窗口 | 问题 来访问 Alt+6 工具窗口。

对于每个问题,您可以按下 Alt+Enter 或单击 显示快速修复 查看建议的快速修复。 要跳转到编辑器中的对应行,请按 F4 ,或在工具窗口中双击问题。

单击 打开编辑器预览 即可直接在工具窗口中查看并修复问题。

滚动条中的彩色条也会标记检测到的代码问题,并帮助您在不滚动文件的情况下快速访问相应行。 将鼠标悬停在彩色条上的标记上可在工具提示中查看检测到的问题。 单击标记即可跳转到对应行。

即时分析结果

您可以通过单击小部件中的 下一个突出显示错误按钮 下一个突出显示错误按钮 或按 F2Shift+F2 ,在文件中各个突出显示的问题之间跳转。 默认情况下,IDE 会根据问题的 严重性来导航您:错误>警告>弱警告>服务器问题>拼写错误。

您可以配置 WebStorm,使其无视严重性依次带您浏览所有问题。 将鼠标悬停在编辑器右上角的小部件上,单击 更多按钮 ,选择 “下一个错误”操作(F2)会遍历 ,然后启用 所有问题

配置高亮行之间的导航

手动运行检查

某些检查需要进行全局代码分析,因此在编辑器中被禁用。 这些检查列在 设置 | 编辑器 | 检查 中。 单击 筛选检查 并选择 仅显示批处理模式检查

如果您希望获取代码中所有问题的完整报告,请手动运行检查。 在这种情况下,IDE 会运行所有在您的 检查配置文件中启用的检查,并在专用工具窗口中显示结果。 完成分析所需的时间取决于启用的检查数量以及所分析范围的大小。

运行所有检查

  1. 在主菜单中,转到 代码 | 检查代码(I)…

  2. 要指定要分析的文件范围,请执行以下操作之一:

    • 选择 整个项目未提交文件

    • 选择 自定义范围 ,然后从列表中选择适当的范围。

      选择自定义检查范围
    • 如果已配置的自定义范围不适合,点击 浏览按钮 ,然后按照 范围与文件颜色 中所述配置新范围。

  3. 选择要应用的 检查配置文件

    要创建新配置文件或修改现有配置文件,请点击 配置…

  4. 点击 分析 开始分析。

“指定检查范围”对话框

项目

描述

整个项目

检查整个项目。

文件 <name>

检查当前在 项目 工具窗口中选中的文件或在编辑器中打开的文件。

未提交文件

此范围仅适用于受版本控制的项目。

仅检查尚未提交到版本控制系统的文件。

自定义范围

检查自定义文件作用域。 从列表中选择预定义范围,或点击 浏览按钮 并在打开的 范围对话框中定义范围。

检查注入的代码

检查嵌入在代码中的 其他语言代码片段

检查配置文件

选择要用于检查代码的 配置文件

如果所需配置文件未在列表中,点击 配置 并创建新配置文件。

运行单个检查

如果想跟踪某个特定问题,运行单次检查非常有用。 如果在文件中发现警告,您可以检查整个项目或所需的文件范围,以确保代码库中不再有此类警告。

  1. Ctrl+Alt+Shift+I ,或在主菜单中转到 代码 | 分析代码 | 通过名称运行检查(R)…

  2. 在弹出窗口中输入检查名称。 使用 CamelHumps 匹配驼峰命名的单词和以首字母缩写形式表示的空格字符。 建议列表将显示与搜索请求匹配的检查。

    如果您不确定选择的是正确的检查,您可以查看其描述。 为此,在弹出窗口中选择某个检查并按 Ctrl+Q

  3. 双击所需的检查。

  4. 在打开的对话框中,选择要分析的文件范围。

    文件掩码(K) 选项可帮助您缩小将要检查的文件数量。

    选中复选框并指定与要分析文件名匹配的字符和通配符模式。 使用顿号分隔多个文件匹配模式。

  5. 某些检查可能有其他选项,系统会提示您进行配置。

    这些设置仅适用于此次运行,不会影响当前配置文件中的检查设置。

    IDE 会在专用工具窗口中显示检查结果。 您可以在其中查看并修复检测到的问题。

    在未提交文件中运行一项检查

提交时代码分析

如果项目使用 Git 或 Mercurial 版本控制,您可以配置 IDE 在提交之前分析已修改的文件。

  1. Alt+0 打开 提交 工具窗口并点击 显示提交选项 设置按钮

  2. 提交检查 区域,选中 分析代码(A) 复选框。

  3. 点击 选择配置文件 ,然后从中选择 IDE 将运行检查的 检查配置文件

    提交前运行检查:提交工具窗口
  4. 点击 提交(I)

    WebStorm 会通过运行所选配置文件中的检查来分析已修改文件中的代码。

    如果检测到任何错误或警告,您将看到通知。

    检测问题的通知
  5. 在通知中,点击 检查代码分析(R) 以在 消息 工具窗口中查看检测到的问题列表。 点击 忽略 以在不修复检测到的问题的情况下提交更改。

使用 Qodana 运行代码检查

该功能在 WebStorm 中默认集成并启用。 如果相关功能不可用,请确认未禁用插件。 有关更多信息,请参见 打开插件设置

您可以使用 Qodana 本地或远程检查代码。 Qodana 的主要使用场景是在 CI/CD 服务器上远程执行资源密集型代码分析。 不过,您也可以在 IDE 中运行相同分析,以确保获得一致结果,并能定位源代码中的问题。

  1. 在主菜单中,转到 工具 | Qodana | 使用 Qodana 尝试代码分析

  2. 选择要在哪里运行检查:本地或在 CI/CD 服务器上。

    要在服务器上运行检查,需先在 CI 中设置 Qodana。

  3. Qodana 配置文件将打开。 在此文件中,您可以指定 Qodana 检查配置文件,启用或禁用特定检查,以及指定应在分析前安装的插件列表。

    点击 运行

分析完成后,报告将显示在 问题 工具窗口的 Qodana 选项卡中。 您可以在本地处理结果,也可以将其发送到 Qodana Cloud

所有 Qodana 分析的本地运行报告都会保存,并可在主菜单中查看: 工具 | Qodana | [报告名称]。 当前打开的报告旁会显示一个复选标记,您可以点击它以关闭该报告。

Qodana 结果

如需了解有关 Qodana 的更多信息,请参阅其 文档

离线运行检查

除了通过 IDE 运行代码检查之外,您还可以在不实际运行 WebStorm 的情况下使用命令行启动检查。 检查结果将存储在 XML 文件中。 如需了解更多信息,请参阅 从命令行运行代码检查

更改作用域顺序

默认情况下,所有启用的代码检查都会分析项目中的所有文件。 根据您的需要,您可以在多个文件范围中使用不同的设置运行相同的检查。

如果某个文件被包含在多个范围中,并且您在这些范围中启用了检查,WebStorm 将根据列表中的顺序进行处理。 列表顶部的范围具有最高优先级,将最先进行分析。

  1. 设置 对话框(Ctrl+Alt+S )中,选择 编辑器 | 检查

  2. 从列表中选择一个检查项。

  3. 在所有作用域中 列表中选择 编辑作用域顺序

    “全部作用域”列表
  4. 选择所需的范围,并使用 向上按钮向下按钮 在列表中上下移动它。

    更改作用域顺序
  5. 如有需要,可创建新的范围。 为此,请点击 编辑按钮编辑作用域… ),指定范围设置,并选择要包含的文件和文件夹。

    包含已添加文件和文件夹的新作用域
最后修改日期: 2025年 9月 26日