# 禁止并忽略检查

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com.cn/help/idea/llms.txt).

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

## 禁用检查

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

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

Procedure: 在设置中禁用检查

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `编辑器 | 检查` 。

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

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

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

Procedure: 从编辑器禁用检查

1. 将插入符号放在高亮行上，然后按 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS))（或点击 ![显示上下文操作图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.codeInsight.intentionBulb.svg)）以调用可用上下文操作的列表。

2. 点击您想要禁用的检查旁边的 ![更多操作按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.moreVertical.svg)，并选择   禁用检查  。

Procedure: 从问题工具窗口禁用检查

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

2. 点击工具栏上的 ![视图选项按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.show.svg)，并选择   筛选已解决的项目   以隐藏已禁用的检查警报。

Procedure: 重新启用检查

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `编辑器 | 检查` 。

也可以按 `Ctrl+Alt+Shift+H` (Windows), `⌘ ⌥ ⇧ H` (macOS), `⌘ ⌥ ⇧ H` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ ⇧ H` (macOS System Shortcuts), `Ctrl+Alt+Shift+H` (XWin), `Ctrl+Alt+Shift+H` (GNOME), `Ctrl+Alt+Shift+H` (KDE), `Ctrl+Alt+Shift+H` (Emacs), `Ctrl+Alt+Shift+H` (Sublime Text), `⌘ ⌥ ⇧ H` (Sublime Text (macOS)), `Ctrl+Alt+Shift+H` (Visual Studio), `⌘ ⌥ ⇧ H` (Visual Studio (macOS)), `Ctrl+Alt+Shift+H` (NetBeans), `Ctrl+Alt+Shift+H` (Eclipse), `⌘ ⌥ ⇧ H` (Eclipse (macOS)) 并选择   配置检查  。

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

修改后的检查项以蓝色显示。 您还可以点击 ![“筛选器检查”按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.filter.svg) 并选择   仅显示已修改的检查   来仅显示设置已更改的检查。

3. 点击   OK  以应用更改。

## 抑制检查

当您  抑制 检查时，代码分析引擎不会在特定代码片段（类、方法、字段或语句）中高亮显示此检查发现的问题。 您还可以在当前类中禁用所有检查。

在 IntelliJ IDEA 中，大多数检查可以被抑制。 然而，有些检查没有此选项。 例如，语法错误始终会在编辑器中高亮显示，无论设置如何。 要了解特定检查是否可以被禁用，请参阅 [Inspectopedia](https://www.jetbrains.com.cn/help/inspectopedia/JavaScript-and-TypeScript.html)。

Procedure: 禁止从编辑器中检查

1. 将文本光标置于高亮显示的行，然后按 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS))（或点击 ![意图操作图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.codeInsight.intentionBulb.svg) 使用意图操作）。

2. 点击要抑制的检查旁边的 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.moreVertical.svg) 按钮，并根据所需作用域选择一个操作。

![抑制检查](https://resources.jetbrains.com.cn/help/img/idea/2026.3/suppress-inspection.png)

Procedure: 从问题工具窗口抑制检查

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

在抑制检查后，IntelliJ IDEA 会在选定的符号之前添加一个新元素。

例如在 Java 中，如果您对类、方法或字段抑制检查，IDE 会添加  `@SuppressWarnings` 注解。 对于语句，会添加  `//noinspection`  注释。

在其他语言中，IDE 会添加其他元素。 例如，在 PHP 中，IntelliJ IDEA 添加  `/** @noinspection */`  注释。 在 Python 中，添加了  `# noinspection`  注释。 在 JavaScript 中，检查通过  `// noinspection`  注释被抑制。

> **Note:**
> 不要手动输入注释和评论来抑制检查。 请改用专用的 [上下文操作](#suppress-in-editor)。

Procedure: 启用已屏蔽的检查

* 要重新启用已禁用的检查，请删除 IDE 在选定符号前添加的注解或注释。

![在 Java 代码中指示已抑制检查的注释和标注](https://resources.jetbrains.com.cn/help/img/idea/2026.3/enable-suppressed-inspection.png)

## 禁用高亮显示，但保留修复

检查具有 [严重性](configuring-inspection-severities.html)，并根据严重性在编辑器中高亮显示代码问题。 您可以在不打开设置的情况下快速禁用检查的代码高亮显示。 在这种情况下，检查保持启用并提供修复，但严重性会更改为   无高亮显示（可用修复）  。

Procedure:

1. 将文本光标置于编辑器中由检查高亮显示的代码元素处，然后按 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS))。

会打开一个可用修复和上下文操作的列表。 找到标记为 ![意图操作图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.codeInsight.intentionBulb.png) 的检查修复。

2. 点击修复旁边的 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.moreVertical.svg) 按钮以打开检查选项并选择   禁用高亮显示，保留修复。​  。

![禁用高亮，保留修复](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ij_disable_highlight_keep_fix.png)

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

如果您想恢复高亮，请按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开 IDE 设置并选择  `编辑器 | 检查` 。 在列表中找到所需的检查并根据需要更改其严重性。 如需更多信息，请参阅 [更改所有范围内的检查严重性](configuring-inspection-severities.html#change-severity)。

## 更改文件的高亮级别

Procedure:

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

* 无 ：关闭高亮显示。

* 语法 ：仅突出语法问题。

* 基础 ：仅在输入时高亮显示关键问题，并在保存文件时显示所有检测到的问题。

* 所有问题 ：（默认）高亮显示语法问题以及检查发现的问题。

![更改文件的高亮级别](https://resources.jetbrains.com.cn/help/img/idea/2026.3/change-highlighting-level.png)

* 也可以从主菜单更改高亮显示级别。 选择  `编码 | 分析代码 | 配置当前文件分析…`  或按 `Ctrl+Alt+Shift+H` (Windows), `⌘ ⌥ ⇧ H` (macOS), `⌘ ⌥ ⇧ H` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ ⇧ H` (macOS System Shortcuts), `Ctrl+Alt+Shift+H` (XWin), `Ctrl+Alt+Shift+H` (GNOME), `Ctrl+Alt+Shift+H` (KDE), `Ctrl+Alt+Shift+H` (Emacs), `Ctrl+Alt+Shift+H` (Sublime Text), `⌘ ⌥ ⇧ H` (Sublime Text (macOS)), `Ctrl+Alt+Shift+H` (Visual Studio), `⌘ ⌥ ⇧ H` (Visual Studio (macOS)), `Ctrl+Alt+Shift+H` (NetBeans), `Ctrl+Alt+Shift+H` (Eclipse), `⌘ ⌥ ⇧ H` (Eclipse (macOS))。

## See also

### 概念

[代码检查](code-inspection.html)

### 过程

[运行检查](running-inspections.html) [意图操作](intention-actions.html)

### 参考

[问题工具窗口](problems-tool-window.html) [检查](inspections-settings.html)