# 查找有漏洞和恶意的依赖项

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

大型复杂的项目通常有许多第三方依赖项，通过扩展常见库和框架的功能来提高生产力。

然而，依赖第三方代码会引发安全问题，因为这可能涉及在项目中使用存在漏洞的依赖项。

捆绑的 IntelliJ IDEA   软件包检查器   插件由 [https://www.mend.io/](https://www.mend.io/jetbrains-lp/?utm_source=JetBrains) 提供支持。该插件会分析 Gradle、Maven、NPM、PyPI 和 sbt 依赖项中的已知漏洞。 它允许您通过检索有关易受攻击依赖项的信息并将其更新到最新发布版本来处理此类情况。

Procedure: 启用 Package Checker 插件

此功能依赖于 [Package Checker](https://plugins.jetbrains.com/plugin/18337-package-checker)插件，该插件默认在 IntelliJ IDEA 中捆绑并启用。 如果相关功能不可用，请确保您没有禁用插件。

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. 找到  软件包检查器  插件并点击   启用  。

[Video](https://www.youtube.com/v/RWtN4WNQsX4)

## 易受攻击的依赖项

Procedure: 在编辑器中修复有漏洞的依赖项

1. 在编辑器中打开  `pom.xml`  或  `build.gradle` 。

IDE 会高亮显示被认为存在漏洞的软件包。

2. 将文本光标置于高亮显示的软件包上，然后按 `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)) 查看建议的修复。 它们可能建议更新到安全版本、访问 [Mend.io](https://www.mend.io/) 网站以了解特定漏洞的更多信息，或 [忽略](#ignore-vulnerabilities) 该漏洞。

![更改依赖项](https://resources.jetbrains.com/help/img/idea/2026.3/change_dependency.png)

Procedure: 分析代码以查找所有易受攻击的依赖项

此外，您可以运行检查以显示项目中所有已声明和导入的易受攻击依赖项列表。

* 在主菜单中，导航到  `代码 | 分析代码 | 漏洞依赖项` 。

* 或者，在   项目  工具窗口 `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))中右键点击一个文件夹或文件（例如，  `pom.xml` 或  `build.gradle` ），然后选择  `分析 | 漏洞依赖项` 。

结果显示在   安全性   选项卡的   问题   工具窗口中（  `视图 | 工具窗口 | 问题`  或 `Alt+6` (Windows), `⌘ 6` (macOS), `⌘ 6` (IntelliJ IDEA Classic (macOS)), `⌘ 6` (macOS System Shortcuts), `Alt+6` (XWin), `Alt+6` (GNOME), `Alt+6` (KDE), `Alt+6` (Emacs), `Alt+6` (Sublime Text), `⌘ 6` (Sublime Text (macOS)), `Alt+6` (Visual Studio), `⌘ 6` (Visual Studio (macOS)), `Alt+6` (NetBeans), `Alt+6` (Eclipse), `⌘ 6` (Eclipse (macOS))）。

![存在漏洞的依赖项](https://resources.jetbrains.com/help/img/idea/2026.3/ij_vulnerable_dependencies_tab.png)

您可以看到每个漏洞的严重程度指示。 点击特定依赖项，以查看在该依赖项中发现的漏洞的详细信息。

> **Tip:**
> 要查看所有项目依赖项，无论它们是否存在漏洞，请点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.inspections.inspectionsEye.svg) 按钮，该按钮位于   安全性   选项卡的左侧面板上，然后选择   显示安全的依赖项  。

Procedure: 忽略漏洞

忽略的漏洞会被添加到检查设置中的列表中。 如有需要，您可以与团队中的其他成员共享此列表中的配置文件。

1. 打开  `pom.xml`  或  `build.gradle`  在编辑器中，将文本光标放在高亮显示的包上，然后按 `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))。

2. 从建议列表中选择   忽略存在漏洞的<package name and version>  ，在打开的对话框中选择忽略此依赖项的原因。 点击   忽略  。

![忽略漏洞](https://resources.jetbrains.com/help/img/idea/2026.3/ij-ignore-vulnerability.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 设置，然后选择  `编辑器 | 检查` 。 展开   安全性   节点并点击   已声明的存在漏洞的依赖项  。 列表位于检查详情的   选项  部分。

了解如何从 [在电脑之间同步配置文件](customizing-profiles.html#sync-inspection-profiles)共享检查配置文件。

## 查找漏洞 API

易受攻击的 API 用法   检查会直接在代码中自动高亮显示易受攻击的 API 和开源库。 您也可以 [手动运行检查](#find-all-vulnerable-apis)以获取项目中所有易受攻击的 API 和开源库的报告。

Procedure: 在编辑器中显示易受攻击的 API

1. 将鼠标悬停在编辑器中检测到的问题上。

弹出窗口显示漏洞详情。

2. 将文本光标置于问题处，按下，然后选择   转到具有声明的依赖项的文件  。

您将被带到定义依赖项的文件中。

3. 将文本光标置于高亮显示的软件包上，然后按 `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)) 查看建议的修复。 它们可能建议更新到安全版本、访问 [Mend.io](https://www.mend.io/) 网站以了解特定漏洞的更多信息，或 [忽略](#ignore-vulnerabilities) 该漏洞。

Procedure: 分析代码以查找所有脆弱的 API

1. 按 `Ctrl+Alt+Shift+I` (Windows), `⌘ ⌥ ⇧ I` (macOS), `⌘ ⌥ ⇧ I` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ ⇧ I` (macOS System Shortcuts), `Ctrl+Alt+Shift+I` (XWin), `Ctrl+Alt+Shift+I` (GNOME), `Ctrl+Alt+Shift+I` (KDE), `Ctrl+Alt+Shift+I` (Emacs), `Ctrl+Alt+Shift+I` (Sublime Text), `⌘ ⌥ ⇧ I` (Sublime Text (macOS)), `Ctrl+Alt+Shift+I` (Visual Studio), `⌘ ⌥ ⇧ I` (Visual Studio (macOS)), `Ctrl+Alt+Shift+I` (NetBeans), `Ctrl+Alt+Shift+I` (Eclipse), `⌘ ⌥ ⇧ I` (Eclipse (macOS)) 或在主菜单中转到  `代码 | 分析代码 | 按名称运行检查…` 。

2. 在  `易受攻击的 API 用法`  中键入并双击检查以打开带有设置的对话框。

3. 选择您要分析的文件范围。

文件掩码(s)   选项可帮助缩小要处理的文件范围。 使用通配符指定一个或多个文件名称模式，以匹配要包含的文件。 使用逗号分隔多个文件掩码。 了解详情，请参阅 [在特定文件类型中搜索](finding-and-replacing-text-in-project.html#exclude_type)。

4. 点击   OK   运行检查。

结果显示在   问题  工具窗口中（  `视图 | 工具窗口 | 问题`  或 `Alt+6` (Windows), `⌘ 6` (macOS), `⌘ 6` (IntelliJ IDEA Classic (macOS)), `⌘ 6` (macOS System Shortcuts), `Alt+6` (XWin), `Alt+6` (GNOME), `Alt+6` (KDE), `Alt+6` (Emacs), `Alt+6` (Sublime Text), `⌘ 6` (Sublime Text (macOS)), `Alt+6` (Visual Studio), `⌘ 6` (Visual Studio (macOS)), `Alt+6` (NetBeans), `Alt+6` (Eclipse), `⌘ 6` (Eclipse (macOS))），您可以从中导航到声明存在漏洞依赖的文件、抑制检查或 [生成报告](resolving-problems.html#export-inspection-results)。

## 报告误报

Procedure:

如果您认为被识别为存在漏洞的依赖项是安全的，可以报告误报。

1. 点击   问题   工具窗口（  `视图 | 工具窗口 | 问题`  或 `Alt+6` (Windows), `⌘ 6` (macOS), `⌘ 6` (IntelliJ IDEA Classic (macOS)), `⌘ 6` (macOS System Shortcuts), `Alt+6` (XWin), `Alt+6` (GNOME), `Alt+6` (KDE), `Alt+6` (Emacs), `Alt+6` (Sublime Text), `⌘ 6` (Sublime Text (macOS)), `Alt+6` (Visual Studio), `⌘ 6` (Visual Studio (macOS)), `Alt+6` (NetBeans), `Alt+6` (Eclipse), `⌘ 6` (Eclipse (macOS))）中   安全性   选项卡上的某个依赖项，以打开其描述。

2. 找到您要报告的漏洞，然后点击   报告误报  。

您将看到一条确认通知。

![报告虚假易受攻击的依赖项](https://resources.jetbrains.com/help/img/idea/2026.3/report-false-vulnerable-dependency.png)

## 恶意依赖项

软件包检查器   插件提供   恶意依赖项   [检查](#configure_inspections)，用于检测项目中声明的恶意 NPM 和 PyPI 依赖项。 修复报告的问题可以防止软件遭到攻击者入侵。

Procedure: 显示恶意依赖项

* 打开声明了 NPM 或 PyPI 依赖项的文件。

IDE 会高亮显示被视为恶意的依赖项。

建议您删除检测到的依赖项。 恶意依赖项数据由 [Mend.io](https://www.mend.io/) 提供。

Procedure: 在提交时查找恶意依赖项

> **Note:**
> 此功能仅适用于 [Git](using-git-integration.html) 和 [Mercurial](using-mercurial-integration.html)。

1. 按 `Alt+0` (Windows), `⌘ 0` (macOS), `⌘ 0` (IntelliJ IDEA Classic (macOS)), `⌘ 0` (macOS System Shortcuts), `Alt+0` (XWin), `Alt+0` (GNOME), `Alt+0` (KDE), `Alt+0` (Emacs), `Alt+0` (Sublime Text), `⌘ 0` (Sublime Text (macOS)), `Alt+0` (Visual Studio), `Alt+0` (Visual Studio (macOS)), `Alt+0` (NetBeans), `Alt+0` (Eclipse), `⌘ 0` (Eclipse (macOS)) 打开   提交   工具窗口，然后点击   显示提交选项   ![设置按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg)。

2. 启用   检查恶意依赖项   选项。

![高级提交选项弹出窗口](https://resources.jetbrains.com/help/img/idea/2026.3/ij_VCS_advanced_commit_options.png)

## 配置安全检查

Procedure:

可以更改 [严重性](configuring-inspection-severities.html)，启用和禁用   安全性   检查，并在设置中配置问题高亮显示。

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. 从右侧选项中选择   安全性   节点并选择检查的名称。

根据需要更改 [严重性](configuring-inspection-severities.html)、作用域和 [高亮显示](configuring-inspection-severities.html#change_highlighting)。 点击   OK   保存更改。

