WebStorm 2026.2 Help

模块依赖关系图

使用 WebStorm,您可以在 JavaScript 和 TypeScript 项目中获取上下文内导入和导出的可视化。

构建模块依赖关系图

  • 从 JavaScript、TypeScript 或 HTML 文件的上下文菜单或文件夹的上下文菜单中选择 图表 | 显示图表

    该操作不适用于 node_modules 已排除 文件夹。

WebStorm 递归分析所选文件或所选文件夹中的所有文件中的 importrequire 语句以及 script 标签,并在单独的选项卡中显示一个图表,展示这些文件之间的相互依赖关系:

ws_module_dependency_diagram.png
  • 一个图表由多个矩形组成。 每个都会显示 分析选择的文件名称以及检测到的导入列表。 如果一个导入被解析,将会在其旁边显示一个指示导入符号类型(例如 variable.png )的图标。

  • 已分析文件指向 目标文件的箭头指示已检测到的导入内容。 如果 目标文件是一个库,则其名称会显示在灰色背景上。 如果从库中导入未解析,则 目标文件显示为带有红色边框的灰色矩形。

  • 解决的 导入导出分别用 import_icon.png 图标标记。

分析图表

分析图表 - 上下文菜单
  • 在图表或节点的上下文菜单中,选择 分析图表 ,然后选择所需操作。

显示图表特性

  • 要获取图表的一般信息和统计数据,请从图表的上下文菜单中选择 分析图 | 显示图特性

  • 要了解某一指标的更多信息,请点击其旁的 帮助图标

显示图表特性

聚焦选中节点

  • 要深入检查多个节点,请选中它们,然后从上下文菜单中选择 分析图 | 聚焦于选中节点

    聚焦于选中节点

    除了当前选中的节点外,其他所有节点都被隐藏。

    聚焦选中节点
  • 要恢复图表,请按 Ctrl+Z

聚焦节点邻域

  1. 要更深入地检查某个节点,请选择所需节点,然后从其上下文菜单中选择 分析图 | 聚焦于节点邻域

  2. 在打开的 将视图聚焦于节点邻域 对话框中,指定要显示的依赖项,然后点击 查找

    聚焦于节点邻域对话框

显示选中节点及其依赖项。

所选节点的邻域

聚焦于两个节点之间的路径

  1. 选择要检查其路径的节点,然后从上下文菜单中选择 分析图 | 聚焦于两个节点之间的路径

    聚焦于两个节点之间路径的上下文菜单
  2. 聚焦于两个节点之间的路径 对话框中,配置搜索条件并点击 查找

    聚焦于两个节点之间路径对话框

聚焦于循环

  1. 要仅查看 循环依赖 ,请从图表的上下文菜单中选择 分析图 | 聚焦于环

  2. 在打开的 将视图聚焦于环 对话框中,指定要显示的循环类型和分析作用域。

    聚焦于循环对话框

图表显示了指定作用域内彼此之间有循环导入的模块。

检测到的循环

测量图表中心性

使用此操作可识别图表中重要的节点。

  1. 从图表的上下文菜单中选择 分析图 | 测量中心性​

  2. 在打开的 测量中心性 对话框中,指定要考虑的关键参数,然后点击 测量

    度量中心性对话框

    WebStorm 会根据节点的计算重要性高亮节点,因此最重要的节点选择颜色最亮。 节点的重要性通过 0.0 到 1.0 的小数值表示,并显示在每个节点旁边。

    中心性测量结果

将节点分组为集群

可以根据节点边的相似性,自动将图中节点分组为集群,采用现代方法确定最佳集群数量。

  1. 从图表的上下文菜单中选择 分析图 | 自动聚类

  2. 在打开的 自动聚类 对话框中,选择用于聚类的参数,然后点击 运行

    自动集群对话框

    WebStorm 显示生成的集群。

    集群

从图表导航至源代码

  • 从图表跳转到文件时,右键点击图表中的文件,然后从上下文菜单中选择 跳转到源

  • 要在源代码中导航到特定的 import 语句,请在图表中右键点击所需的文件,从上下文菜单中选择 跳转到 ,然后从 选择导航目标 列表中选择要跳转到的符号:

    ws_module_dependency_diagram_jump_to.png

上下文菜单

选定元素操作

当图表中选中了节点时,将显示此菜单项及该节点下的项目。

条目

描述

复制

复制所选内容。

查找用法

在整个项目中 搜索所选内容的用法

显示

查看所选内容的引用信息,例如:

转到

打开位置

  • 文件路径 - 选择此选项可查看选中项所在的文件夹。

    在文件路径中打开
  • 在终端中打开 - 在 终端中打开与选定项对应的目录。

使用 Google 搜索

打开浏览器,并使用 Google 搜索所选项的文件路径。

使用 Google 搜索

外部工具

针对所选项运行 外部工具

内容

条目

描述

新建

仅当在图表中选中节点时该项目才可用。 使用此项目可向当前图表添加以下类型的备注。

  • 备注

  • 带元素文档的备注

更改可见性级别

选择详细程度级别,可用选项如下:

  • 概览

  • 详细信息

可在 yFiles 官方网站了解更多信息。

跳转到

仅当在图表中选中节点时该项目才可用。 使用此项目可打开一个弹出列表,显示所选项所包含文件的导入。 点击弹窗中的文件,可在编辑器中打开它。

跳转到

Delete

仅当图表中选中至少一个节点时该操作可用。 使用该操作可从图表中移除所选节点。

分析图表

选择此项以访问用于分析图表的操作 如上所述

重构

仅当选中了节点时该菜单项可用。 使用该菜单项可打开弹出列表,显示当前上下文可用的重构操作:

布局

选择此菜单项可打开弹出列表,显示可用的图表布局。 可在 yFiles 官方网站了解更多信息。

方向

选择此项可打开弹出列表,选择如何在屏幕上可视化排列图表。

应用当前布局

选择此菜单项以应用当前从图表上下文菜单 布局 列表中选择的布局。 该操作也可通过工具栏使用。

自动路由边

将图表内容缩放至图表窗口边界。 该操作也可通过工具栏使用。

外观

使用此菜单项可配置边和标签的显示效果,指定是否显示网格等。 可在 yFiles 官方网站了解更多信息。

行为

使用该菜单项打开弹出列表,可在其中启用或禁用以下选项:

  • 对齐到网格

  • 布局后适应内容

    自动布局算法完成图形排列后,视口会自动缩放和平移,使整个图表适配可视区域。

    启用该设置时:将通过布局算法重新排列节点和边。 画布/视图将自动调整以显示所有内容,无需手动缩放或滚动。

    启用该设置时:布局依然会运行,但当前缩放级别和视口位置保持不变。

  • 为选中节点显示结构视图 - 启用此选项可让 WebStorm 自动显示与当前选中节点对应文件的 结构视图

将图表复制到剪贴板

该操作也可通过工具栏使用。

将所选内容复制到剪贴板

选择该菜单项,然后选择任意图表区域——所选区域将被复制到剪贴板。 该操作也可通过工具栏使用。

导出图表

可使用与第三方工具兼容的多种格式将图表导出为文件、图像或在浏览器中打开。

导出图表

您可以选择并配置以下选项:

  • 在 Web 编辑器中打开 :单击此按钮以选择要将图表导出到的第三方编辑器。

  • 将图表复制到剪贴板 :单击此按钮以使用可用格式之一将图表保存到剪贴板。

  • 保存图表 :单击此按钮以将当前图表保存为文件。 您可以使用列表中的可用格式之一。

  • 保存图片 :单击此按钮以将当前图表保存为 PNG 格式。

  • 打印 :单击此按钮以打印图表。

该操作也可通过工具栏使用。

工具栏

条目

描述

显示可见性级别

点击此图标以选择详细程度级别,可用选项如下:

  • 概览

  • 详细信息

可在 yFiles 官方网站了解更多信息。

放大/缩小

放大/缩小图表

实际大小

点击此图标即可恢复图表的原始大小,即放大或缩小前的大小。

适应内容

点击此图标以使内容适应当前图表大小。

应用当前布局

点击此图标以应用当前从图表上下文菜单 布局 列表中选择的布局。

自动路由边

点击此图标,将图表内容缩放至图表窗口边界。

将图表复制到剪贴板

单击此图标将图表复制到剪贴板。

将所选内容复制到剪贴板

点击此图标,然后选择任意图表区域——所选区域将被复制到剪贴板。

导出图表

单击此图标可使用与第三方工具兼容的多种格式将图表导出为文件或图像,或在浏览器中打开图表。

导出图表

您可以选择并配置以下选项:

  • 在 Web 编辑器中打开 :单击此按钮以选择要将图表导出到的第三方编辑器。

  • 将图表复制到剪贴板 :单击此按钮以使用可用格式之一将图表保存到剪贴板。

  • 保存图表 :单击此按钮以将当前图表保存为文件。 您可以使用列表中的可用格式之一。

  • 保存图片 :单击此按钮以将当前图表保存为 PNG 格式。

  • 打印 :单击此按钮以打印图表。

刷新数据模型

点击此按钮以刷新整个图表。

打开图表设置

单击此按钮以打开 图表设置 ,您可以在其中配置其他选项。

2026年 7月 14日