PyCharm 2025.2 Help

UML 类图

启用 Diagrams 插件

此功能依赖于 Diagrams 插件,该插件默认在 PyCharm 中捆绑并启用。 如果相关功能不可用,请确保您未禁用该插件。

  1. 按下 Ctrl+Alt+S 打开设置,然后选择 插件

  2. 打开 已安装 选项卡,找到 Diagrams插件,并勾选插件名称旁边的复选框。

PyCharm 允许您在项目中的包上生成图表。 这种图表总是反映您应用程序中实际类和方法的结构。

查看 UML 类图

  1. 项目 工具窗口中,右键单击要为其创建图表的项目,然后选择 图表 | 显示图表 Ctrl+Alt+Shift+U

  2. 在打开的列表中,选择 Python 类图。 PyCharm 为类及其依赖关系生成一个 UML 图。

以图表形式查看本地更改

您可以使用 UML 类图来评估本地代码更改对应用程序的影响。

  • 在代码编辑器、 项目 工具窗口或 提交 窗口的上下文菜单中,选择 以 UML 显示本地更改 ,或按下 Ctrl+Alt+Shift+D

    图表将在弹出窗口中打开。 您可以双击节点以在 差异查看器 中查看更改。

要以 UML 类图形式查看修订中的更改,请在 历史记录选项卡版本控制工具窗口 中,选择所需的修订版本,然后从上下文菜单中选择 以 UML 显示差异 或按 Ctrl+Shift+D

分析类图

要查看方法、字段和其他代码元素的列表,请在位于图表编辑器顶部的图表工具栏中选择相应的 icon

py_class_dependencies.png

当您点击图中的类时,PyCharm 会将不属于同一包的类变灰。 当您在包含内部包的包上生成图表时,这可能会有所帮助。

要将图表保存为文件,请右键点击图表编辑器,并从上下文菜单中选择 导出图表 | 导出到文件 ,然后选择您想要保存图表的文件扩展名。

管理类图

在使用图表时,请使用图表编辑器中的上下文菜单来执行不同的任务。 您可以查看类的成员、新增、删除现有成员、查看实现情况、检查父类、执行基本重构、添加备注等。

您可以通过选择图表元素并按 F4 导航到底层源代码。

在图表中选择元素

  • 要选择一个元素,请在图表中单击它。

  • 要选择多个相邻的元素,请按住 Shift 并单击所需的元素,或者直接在要选择的元素周围拖动一个 套索

  • 要选择多个不相邻的元素,请按住 Ctrl+Shift 并单击所需的元素。

  • 要选择类成员,请双击类元素,然后使用箭头键或鼠标指针。

将现有类添加到图表

  1. 按下 Space

  2. 在打开的搜索字段中,开始输入您想要添加的类的名称。 然后,从建议列表中选择所需的类。

    umlPopup.png

    如果您想添加超出项目范围的类,请选择 包括非项目项 复选框。

从图表中删除节点元素

  1. 在图表编辑器中,选择您想删除的节点元素。

  2. 右键点击该元素,然后从上下文菜单中选择 删除 Delete

    或者,选择 重构 | 安全删除 Alt+Delete。 在这种情况下,PyCharm 会在应用更改之前检查 用法

查看实现和父类

您可以在图表中查看实现和父类。 如果 PyCharm 找到多个父类或实现,它将显示一个合适项的列表。 选择您需要的以查看父项及其子项之间的关联。

  1. 在图表编辑器中,选择您希望查看其实现或父类的项目。

  2. 右键点击项目,然后从上下文菜单中分别选择 显示实现 Ctrl+Alt+B显示父级 Ctrl+Alt+P

  3. 在打开的弹窗中,选择您需要的项目并按 Enter。 要在弹出窗口中向上或向下扩展您的选择,请分别按 Shift+UpShift+Down

配置图表设置

您可以配置图表设置,以便在创建图表时默认提供某些选项。

  1. 按下 Ctrl+Alt+S 以打开设置,然后选择 工具 | 图表

  2. 在右侧窗格中,选择您希望默认看到的选项,然后点击 确定 以应用您的更改。

分析图表

分析图表 动作组可让您以多种方式分析图形,例如执行自动聚类、测量节点中心性、搜索环、过滤两个节点之间的路径等。

在两个节点之间过滤路径

大多数情况下,生成的图表又大又复杂。 通常,您只需专注于图表的特定部分。 PyCharm 允许您过滤两个图表元素之间的路径。

  1. 在图表编辑器中,选择两个您想要聚焦的节点,然后右键点击其中一个以打开上下文菜单。

  2. 从上下文菜单中选择 分析图形|聚焦于两个节点之间的路径

  3. 在打开的对话框中,选择需要的其他选项,然后点击 查找

    PyCharm 仅显示与所选节点关联的连接。

测量图中心性

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

  1. 在图表编辑器中,右键点击编辑器的任意位置以打开上下文菜单。

  2. 从上下文菜单中选择 分析图 | 测量中心性

  3. 在打开的对话框中,选择需要的其他选项,然后点击 测量

    节点“ importance ”通过从 0.0 到 1.0 的小数值来表示,应首先探索最亮的节点。

提高效率的提示

管理图表布局

右键单击图表背景,并从上下文菜单中选择 布局。 然后从子菜单中选择布局。 要应用所选布局,请单击图表工具栏中的 应用当前布局按钮

或者,手动拖动图表中的实体以实现所需的布局。

放大和缩小

使用以下任意技术:

  • 单击图表编辑器工具栏中的 放大按钮缩小按钮

  • 按住 Ctrl ,旋转鼠标滚轮。

  • NumPad+NumPad-

使用放大工具

按住 Alt ,将鼠标悬停在图表区域上。

以图表形式查看数据库或表的结构

数据库工具窗口 中,右键单击架构或表,并从上下文菜单中选择 图表 | 显示可视化 Ctrl+Alt+Shift+U图表 | 显示可视化弹窗 Ctrl+Alt+U

以图表形式查看 SQL 查询计划

在编辑器中,右键单击 SQL 语句并选择 解释计划。 然后,在 输出 窗格中,切换到 计划 选项卡。 默认情况下,查询以树形显示。 要将其显示为图表,请单击 显示可视化显示可视化按钮 )或按 Ctrl+Alt+Shift+U

工具栏

项目

描述

字段

点击此按钮以在类节点中显示字段。

方法

点击此按钮以显示类节点中的方法。

内部类

点击此按钮以显示类节点中的内部类。

放大

点击此按钮以增加图表的比例,或按 NumPad+

缩小

点击此按钮以缩小图表比例,或按 NumPad-

实际大小

点击此按钮以恢复图表的实际尺寸。

适应内容

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

应用当前布局

点击此按钮以应用从图表的上下文菜单中选择的当前布局,或按 F5

路由装订区域

点击此图标以将图表缩放到窗口装订区域。

将图表复制到剪贴板

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

将选定内容复制到剪贴板

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

保存图表

点击此按钮以将当前图表保存为 UML 文件。

导出图表

点击此图标以使用各种格式导出图表,这些格式与第三方工具兼容,可以导出到文件、图像,或在浏览器中打开图表。

导出图表

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

  • 在 Web 编辑器中打开 :点击此按钮以选择一个第三方编辑器,您可以将图表导出到该编辑器。

  • 将图表复制到剪贴板 :点击此按钮以其中一种可用格式将图表保存到剪贴板。

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

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

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

打印

点击此按钮以打印图表。

上下文菜单

下表包含工具栏中不可用的命令。

项目

描述

新建

使用此节点向图表添加新元素。

显示类别

显示或隐藏类别,例如方法、内部类和字段。

添加类到图表

支持将现有类添加到图表中。 开始输入类名,然后从自动完成功能列表中选择目标项。

删除

删除所选的图表。

重构

此节点包含在当前上下文中启用的重构命令。

跳转到源

选择此命令以在编辑器中打开选定的图表节点元素。

查找用法

选择此命令以 搜索选定节点元素的用法

实际大小

恢复图表的实际大小。

适应内容

适应当前图表大小的内容。

布局

从子菜单中选择所需的图表布局。

方向

为您提供以下方向选项:从下到上、从上到下。

应用当前布局

将当前布局应用于从图表上下文菜单的 布局 节点中选择的布局

路由装订区域

将图表内容缩放至图表窗口的装订区域。

选项卡外观

通过显示网格、装订区域标签、桥来管理图表的呈现方式。 允许您合并装订区域并选择装订区域形状。

对齐到网格。

将元素对齐到网格。

在布局后调整内容

选择布局后,将适配图表内容。 默认启用。

将图表复制到剪贴板

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

将选定内容复制到剪贴板

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

导出为图像文件

将图表保存为具有指定名称和路径的图像文件。 可能的格式为: jpeg png svg svgz gif

打印

打印图表。

保存 UML 图

将当前图表保存为指定位置的 xml 文件。

类图图例

PyCharm 遵循 UML 约定 展示类之间的关系。

除此之外,PyCharm 支持以下颜色和箭头:

项目

描述

实现

绿色箭头对应类声明中的 implements 子句。

extends

蓝色箭头对应类的扩展。

内部类

此标志出现在内部类中。

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