PhpStorm 2025.2 Help

禁用和启用检查

有些检查可能会报告您当前不希望看到的问题。 在这种情况下,您可以禁用或抑制它们。

禁用检查

当您 禁用检查时,您将其关闭。 这意味着代码分析引擎将停止在项目文件中搜索此检查旨在检测的问题。 请注意,当您禁用某个检查时,您是在当前检查配置文件中禁用它;它在其他配置文件中仍然是启用的。

在 PhpStorm 中,大多数检查都可以禁用。 但是,一些检查将会不管设置如何继续高亮显示您的代码。 例如,语法错误始终会被高亮显示。

在设置中禁用检查

  1. Ctrl+Alt+S 打开设置,然后选择 编辑器|检查

  2. 找到您想要禁用的检查,并清除其旁边的复选框。

  3. 应用更改并关闭对话框。

您可以直接在编辑器中使用上下文操作快速禁用触发的检查。

从编辑器禁用检查

  1. 将插入符号放在高亮行上,然后按 Alt+Enter (或单击 显示上下文操作图标 )以调用可用上下文操作的列表。

  2. 单击您想要禁用的检查旁边的 更多操作按钮 ,并选择 禁用检查

从问题工具窗口禁用检查

  1. 检查结果 选项卡的 问题 工具窗口中(在您运行代码分析后显示),右键点击您想要禁用的检查并选择 禁用检查

  2. 单击工具栏上的 视图选项按钮 ,并选择 筛选已解决的项目 以隐藏已禁用的检查警报。

重新启用检查

  1. Ctrl+Alt+S 打开设置,然后选择 编辑器|检查

    您也可以按下 Ctrl+Alt+Shift+H 并选择 配置检查

  2. 在列表中找到已禁用的检查并选中其旁边的复选框。

    修改后的检查项以蓝色显示。 您还可以点击 “滤镜检查”按钮 并选择 仅显示已修改的检查 来仅显示设置已更改的检查。

  3. 点击 确定 以应用更改。

禁止检查

当您 抑制检查时,代码分析引擎不会在特定代码片段(类、方法、属性或语句)中高亮显示该检查发现的问题。 您可以在整个 JavaScript 和 TypeScript 类及文件中抑制检查。 在 HTML 和 Vue.js 中,也可以在整个文件中抑制检查。

在 PhpStorm 中,大多数检查可以被抑制。 然而,有些检查没有此选项。 例如,语法错误始终会在编辑器中高亮显示,无论设置如何。

禁止从编辑器中检查

  1. 将文本光标放置在高亮行并按 Alt+Enter (或点击 意图操作图标 使用意图操作)。

  2. 单击您想要抑制的检查旁边的 按钮,并根据所需范围选择一个操作。

    抑制检查

    在 TypeScript 或 JavaScript 文件中,您可以在整个 TypeScript 或 JavaScript 类或文件中抑制检查。

    在 JavaScript 类中抑制检查

    在 HTML 和 Vue.js 文件中,您可以在当前标签内抑制检查,或在整个文件中抑制检查,甚至抑制当前文件中的所有检查。

    在样式表中,可以在当前语句或当前规则集中抑制检查。 您还可以在规则集中抑制所有检查。

从问题工具窗口抑制检查

  • 检查结果 选项卡中的 问题 工具窗口(运行代码分析后出现),右键点击您要抑制的检查并选择所需的抑制操作。

启用已屏蔽的检查

当您抑制检查时,IDE 会在选定符号前添加 /** @noinspection */ 注解。 例如,如果您为语句抑制检查,PhpStorm 会在该语句前添加注解。

  • 要重新启用已抑制的检查,请删除 /** @noinspection */ 注解。

    语句前的 -- noinspection 注解

禁用突出显示,但保留修复

检查具有 严重性 ,根据这些严重性,它们在编辑器中突出显示代码问题。 您可以在不打开设置的情况下快速禁用检查的代码高亮显示。 在这种情况下,检查保持启用并提供修复,但严重性会更改为 无高亮显示(修复可用)

  1. 将文本光标放置在编辑器中由检查突出显示的代码元素处,然后按 Alt+Enter

    会打开一个可用修复和上下文操作的列表。 找到标记为 意图操作图标 的检查修复。

  2. 点击修复旁边的 按钮以打开检查选项并选择 禁用高亮显示,保留修正

    禁用高亮,保留修复

检查选项上方写有您正在更改严重性的检查名称。

如果您想恢复高亮,请按 Ctrl+Alt+S 打开 IDE 设置并选择 编辑器|检查。 在列表中找到所需的检查并根据需要更改其严重性。 有关更多信息,请参阅 更改所有范围内的检查严重性

更改文件的高亮级别

  • 默认情况下,PhpStorm 会突出显示所有检测到的代码问题。 将鼠标悬停在编辑器右上角的小部件上,然后从 高亮显示 列表中选择另一级别:

    • :关闭高亮显示。

    • 语法 :仅突出语法问题。

    • 所有问题 :(默认)突出显示语法问题和检查发现的问题。

    更改文件的高亮级别
  • 您还可以从主菜单中更改突出显示级别。 选择或按 Ctrl+Alt+Shift+H

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