# 依赖性分析

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

如果您有一个包含多个模块并使用多个库的大型 Java 项目，任何需要进行重要结构变更的操作都可能会很困难。 例如，如果您决定删除其中一个库、提取一个 API 或一个新模块，或通过切换到 [Java 9 Jigsaw](https://openjdk.java.net/projects/jigsaw/) 模块对您的应用进行模块化处理，您需要分析项目中的依赖关系，以确保您的更改不会破坏任何内容。

IntelliJ IDEA 提供了一种工具，允许您在应用程序的模块、包和类之间 [分析依赖](#analyze-dependencies)，并为结构更改做好准备——依赖分析器。

> **Tip:**
> 在 IntelliJ IDEA 中，您可以可视化项目各部分（模块、类等）之间的依赖关系，并使用 [Dependency Structure analysis](dsm-analysis.html) 突出信息流。

## 分析依赖性

Procedure:

1. 在主菜单中，前往  `代码｜分析代码｜依赖项` 。

或者，如果要分析特定条目，请在   项目   工具窗口中右键点击它并选择  `分析 | 分析依赖项` 。

2. 在打开的对话框中，指定您要分析的文件范围。

![选择分析范围](https://resources.jetbrains.com/help/img/idea/2026.3/dependency-analysis-scope-dialog.png)

如果尚未创建必要的 scope，请点击 !["添加范围（插入）"图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg)并在打开的对话框中 [定义一个新的 scope](configuring-scopes-and-file-colors.html#creating-a-new-custom-scope)。

3. 如果要将测试代码与生产代码一起分析，请选择   包含测试源   选项。

4. 如果要分析传递依赖项并指定所需阈值，请选择   显示传递依赖关系   选项。

例如，A 依赖于 B，B 依赖于 C。 将阈值设置为 1 后，IDE 将为 A 显示 B 和 C 依赖项。 将阈值设置为 0 后，将只为 A 显示 B 依赖项。

5. 点击   分析   运行分析。

分析完成后，结果会显示在   依赖查看器   工具窗口中。

6. 在工具窗口的左侧窗格中，选择要在其中搜索依赖项的节点。

7. 在右侧窗格中，选择所选节点所依赖的节点。

搜索结果显示在工具窗口的下窗格中。 使用工具栏上的 [选项](#toolbar1)来管理搜索结果。

![工具窗口中的依赖分析结果](https://resources.jetbrains.com/help/img/idea/2026.3/analyze-dependencies-results.png)

## 分析模块依赖性

模块依赖分析显示了在指定范围内存在的所有模块、在 [Dependencies](working-with-module-dependencies.html) 选项卡中的   项目结构   对话框中指定的这些模块之间的关系以及模块之间的循环依赖关系。

您可以使用这种类型的分析来确保您之前定义的依赖关系仍然存在于您的项目中。

Procedure:

1. 在主菜单中，前往  `代码｜分析代码｜模块依赖项` 。

如果在   项目  工具窗口中没有选择模块，系统会提示您指定分析范围。 您可以检查整个项目、当前模块或模块组。

或者，右键点击   项目   工具窗口中的一个模块，然后选择  `分析 | 分析模块依赖关系` 。

2. 模块依赖关系  工具窗口打开，列出了所选文件范围内的所有模块。

如果在选定的模块中发现任何 [cyclic dependencies](#cyclic)，它们将显示在工具窗口的右侧。

![模块依赖关系工具窗口](https://resources.jetbrains.com/help/img/idea/2026.3/analyzeModuleDependencies.png)

3. 在树视图中选择一个模块，然后点击 !["分析依赖项"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.ide.hectorOff.svg) 工具窗口的工具栏上的   模块依赖关系   来查找依赖于所选模块的模块。

4. 在打开的对话框中，指定您要分析的文件范围。

5. 如果要将测试代码与生产代码一起分析，请选择   包含测试源   选项。

6. 如果要分析传递依赖项并指定所需阈值，请选择   显示传递依赖关系   选项。

例如，A 依赖于 B，B 依赖于 C。 将阈值设置为 1 后，IDE 将为 A 显示 B 和 C 依赖项。 将阈值设置为 0 后，将只为 A 显示 B 依赖项。

7. 点击   分析   运行分析。

分析完成后，结果会显示在   依赖查看器   工具窗口中。

8. 在工具窗口的左侧窗格中，选择要在其中搜索依赖项的节点。

9. 在右侧窗格中，选择所选节点所依赖的节点。

搜索结果显示在工具窗口的下窗格中。 使用工具栏上的 [选项](#toolbar1)来管理搜索。

### 模块依赖关系工具窗口

运行  Analyze Module Dependencies  选项后，将会显示此工具窗口，并根据模块设置中的定义显示模块依赖关系。 在此工具窗口中，您可以更改依赖关系的方向并对源代码进行更详细的分析。

#### 工具栏按钮

|  条目  |  描述  |
| --- | --- |
|  ![关闭](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.close.svg)  |  关闭当前选项卡。  |
|  ![分析依赖关系](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.rerun.svg)  |  打开   指定依赖分析范围  对话框并分析依赖。  |
|  ![向后依赖](https://resources.jetbrains.com/help/img/idea/2026.3/app.hierarchy.subtypes.svg)  |  更改依赖关系的方向。  |
|  ![包含测试依赖项](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.nodes.testSourceFolder.png)  |  包括测试依赖项。  |

#### 上下文菜单选项

|  条目  |  快捷键  |  描述  |
| --- | --- | --- |
|  展开全部 / 折叠全部  |  `Ctrl+NumPad +` (Windows), `⌘ NumPad +` (macOS), `⌘ NumPad +` (IntelliJ IDEA Classic (macOS)), `⌘ NumPad +` (macOS System Shortcuts), `Ctrl+NumPad +` (XWin), `Ctrl+NumPad +` (GNOME), `Ctrl+NumPad +` (KDE), `Ctrl+NumPad +` (Emacs), `Ctrl+NumPad +` (Sublime Text), `⌘ NumPad +` (Sublime Text (macOS)), `Ctrl+NumPad +` (Visual Studio), `⌘ NumPad +` (Visual Studio (macOS)), `Ctrl+NumPad +` (NetBeans), `Ctrl+Shift+NumPad *` (Eclipse), `⌘ ⇧ NumPad *` (Eclipse (macOS)) / `Ctrl+NumPad -` (Windows), `⌘ NumPad -` (macOS), `⌘ NumPad -` (IntelliJ IDEA Classic (macOS)), `⌘ NumPad -` (macOS System Shortcuts), `Ctrl+NumPad -` (XWin), `Ctrl+NumPad -` (GNOME), `Ctrl+NumPad -` (KDE), `Ctrl+NumPad -` (Emacs), `Ctrl+NumPad -` (Sublime Text), `⌘ NumPad -` (Sublime Text (macOS)), `Ctrl+NumPad -` (Visual Studio), `⌘ NumPad -` (Visual Studio (macOS)), `Ctrl+NumPad -` (NetBeans), `Ctrl+Shift+NumPad /` (Eclipse), `⌘ ⇧ NumPad /` (Eclipse (macOS))  |  折叠或展开所有节点。  |
|  打开模块设置  |  `F4` (Windows), `⌘ ↓` (macOS), `F4` (IntelliJ IDEA Classic (macOS)), `F4` (macOS System Shortcuts), `F4` (XWin), `F4` (GNOME), `F4` (KDE), `F4` (Emacs), `F4` (Sublime Text), `F4` (Sublime Text (macOS)), `F4` (Visual Studio), `⌘ ↓` (Visual Studio (macOS)), `F4` (NetBeans), `F12` (Eclipse), `F3` (Eclipse (macOS)) `Ctrl+Enter` (Windows), `⌘ ⏎` (macOS), `⌘ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ ⏎` (macOS System Shortcuts), `Ctrl+Enter` (XWin), `Ctrl+Enter` (GNOME), `Ctrl+Enter` (KDE), `Ctrl+Enter` (Emacs), `Ctrl+Enter` (Sublime Text), `⌘ ⏎` (Sublime Text (macOS)), `Ctrl+Enter` (Visual Studio), `⌘ ⏎` (Visual Studio (macOS)), `Ctrl+Enter` (NetBeans), `Ctrl+Enter` (Eclipse), `⌘ ⏎` (Eclipse (macOS))  |  在   项目结构   对话框 ( `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS))) 的   模块页面   中打开所选模块的设置。  |
|     分析依赖关系       分析向后依赖关系       分析循环依赖关系     |  |  选择下列选项之一以分析依赖项。  |

> **Tip:**
> 要在您的项目中直观地展示模块依赖关系，请使用 [模块依赖图](project-module-dependencies-diagram.html)。

## 分析循环依赖关系

通过分析循环依赖，您可以检测指定范围内包之间的循环关系。

例如，当包 1 中的类引用包 2 中的类，包 2 中的类引用包 3 中的类，包 3 中的类引用包 1 中的类时，就会发生循环。

![方案中的循环依赖](https://resources.jetbrains.com/help/img/idea/2026.3/cycle-dependencies-scheme.png)

Procedure:

1. 在主菜单中，前往  `代码｜分析代码｜循环依赖项` 。

或者，在   项目   工具窗口中右键点击某项，然后选择  `分析 | 分析循环依赖关系` 。

2. 在   指定循环依赖分析范围  对话框中，选择您想要分析的文件范围。

3. 如果要将测试代码与生产代码一起分析，请选择   包含测试源   选项。

![为分析循环依赖关系选择范围](https://resources.jetbrains.com/help/img/idea/2026.3/cyclic-dependencies.png)

4. 点击   OK   运行分析。

分析完成后，结果会显示在   依赖查看器   工具窗口中。

5. 在工具窗口的左侧窗格中，选择您要在其中搜索循环依赖的节点。

6. 搜索结果显示在右侧窗格。 使用工具栏上的 [选项](#toolbar1)来管理搜索结果。

![循环依赖分析结果显示在工具窗口中](https://resources.jetbrains.com/help/img/idea/2026.3/cyclic-dependencies-results.png)

## 分析向后依赖关系

通过此类分析，您可以在某个文件范围内找到依赖于指定分析范围（整个项目、模块、文件、未版本化文件等）的其他类或模块。

分析向后依赖关系可能会耗费时间，尤其是在大型项目中。

Procedure:

1. 在主菜单中，前往  `代码｜分析代码｜反向依赖项` 。

或者，如果要分析特定条目，请在   项目   工具窗口中右键点击它并选择  `分析 | 分析反向依赖关系` 。

2. 在对话框的   分析范围   部分，指定您想要查找的项目依赖项。

3. 选择   包含测试源  复选框以分析测试源。

4. 在   分析用法于：  部分中，指定您要搜索依赖项的范围。

![进行向后依赖分析](https://resources.jetbrains.com/help/img/idea/2026.3/backward-dependencies.png)

5. 分析完成后，结果会显示在   依赖查看器   工具窗口中。

6. 在工具窗口的左侧窗格中，选择您要搜索的文件或文件范围。

7. 在右侧窗格中，选择您要搜索选定依赖项的范围。

搜索结果显示在工具窗口的下窗格中。 使用工具栏上的 [选项](#toolbar1)来管理搜索。

## 依赖查看器

分析完成后，   依赖查看器  工具窗口会自动打开并显示结果。 要手动打开工具窗口，请转到主菜单中的  `视图｜工具 Windows｜依赖项查看器` ，但请确保先运行分析。

依赖查看器   由以下区域组成：

* 工具窗口顶部的工具栏。 请使用这些 [按钮](#toolbar1)来筛选依赖项。

* 工具窗口左侧的 已分析的代码 面板包含项目树。 选择想要查找依赖项的项目会打开 父代码 窗格。

* 右侧的 父代码 窗格显示了您的选择所依赖的项目。

* 工具窗口底部的 用法 窗格会在您选择 父代码 窗格中的项目时打开。

![分析向后依赖](https://resources.jetbrains.com/help/img/idea/2026.3/backward-dependencies-animation.animated.gif)

### 分析代码工具栏按钮

|  条目  |  工具提示和快捷键  |  描述  |
| --- | --- | --- |
|  ![关闭](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.close.svg)  |  关闭  |  关闭工具窗口的当前选项卡。  |
|  ![重新运行](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.rerun.svg)  |    重新运行   `Ctrl+F5` (Windows), `⌘ R` (macOS), `⌃ F5` (IntelliJ IDEA Classic (macOS)), `⌘ R` (macOS System Shortcuts), `Ctrl+F5` (XWin), `Ctrl+F5` (GNOME), `Ctrl+5` (KDE), `Ctrl+F5` (Emacs), `Ctrl+F5` (Sublime Text), `⌘ R` (Sublime Text (macOS)), `Ctrl+Alt+R` (Visual Studio), `⌘ ⌥ R` (Visual Studio (macOS)), `Ctrl+F5` (NetBeans), `Ctrl+F5` (Eclipse), `Ctrl+F5` (Eclipse (macOS))  |  在相同标签中重新运行依赖性分析。  |
|  ![扁平化软件包](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.objectBrowser.flattenPackages.svg)  |  扁平化软件包  |  将所有包显示为单层树视图。  |
|  ![显示文件](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.fileTypes.unknown.png)  |  显示文件  |  在   已分析的代码   和   父代码   面板上显示文件。 否则，两个窗格只显示包。  |
|  ![显示模块](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.actions.groupByModule.png)  |  显示模块  |  在树状视图中显示相应模块下的项目。 否则，项目项会显示在它们的包下。  |
|  ![扁平化模块](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.objectBrowser.flattenModules.svg)  |  扁平化模块  |  按用户定义的模块组排列树中的项目。  |
|  ![按范围类型分组](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.actions.groupByTestProduction.svg)  |  按作用域类型分组  |  将树中的项目按范围分组（生产、测试、库等）。  |
|  ![过滤器](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.filter.svg)  |  仅显示非法项  |  仅显示非法和无效的依赖项。  |
|  ![标记为非法](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.actions.lightning.svg)  |  标记为非法  |  将所选依赖项标记为非法。  |
|  ![设置](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg)  |  编辑规则  |  为依赖分析 [定义规则](#validate-dependencies)。  |
|  ![导出到文本文件](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.export.svg)  |  导出到文本文件  |  将分析结果导出到文本文件或复制到剪贴板。  |

## 验证依赖关系

在分析依赖关系时，您可能需要从分析过程中排除某些依赖关系。 您可以使用   验证依赖项   选项来完成此操作。

Procedure:

1. 在   依赖查看器  工具栏上，点击 ![编辑规则](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg)   编辑规则  按钮。

在打开的对话框中，声明描述无效和有效依赖关系的规则。

2. 在对话框的所需部分中根据您要创建的规则点击 !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)。

拒绝使用:

1.  从   拒绝使用   列表中选择将会被识别为无效的依赖项。

2.

从   在   列表中，选择将选定用法视为无效的文件范围。

如果尚未创建所需作用域，请点击 !["添加范围（插入）"图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg)，并在打开的对话框中 [定义新作用域](configuring-scopes-and-file-colors.html#creating-a-new-custom-scope)。

允许使用:

1.  从   允许使用   列表中选择将被识别为有效的依赖项。

2.

从   仅在  列表中，选择将所选用法视为有效的文件范围。 这些用法仅在使用于此范围内时才有效。

如果尚未创建所需作用域，请点击 !["添加范围（插入）"图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg)，并在打开的对话框中 [定义新作用域](configuring-scopes-and-file-colors.html#creating-a-new-custom-scope)。

3. 如果您希望忽略 import 语句中的引用，请选择   跳过 import 语句   复选框。

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

![依赖项验证对话框](https://resources.jetbrains.com/help/img/idea/2026.3/dependency-validation.png)

点击 ![重新运行按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.rerun.svg)工具栏上的 [依赖查看器](#dependency-viewer)，以使用新规则重新运行分析。

## See also

### 过程

[Module dependencies](working-with-module-dependencies.html) [模块依赖图](project-module-dependencies-diagram.html) [依赖结构矩阵](dsm-analysis.html)

