# 一.简单介绍

# 1.什么是 PlantUML?

PlantUML 是一种用于绘制 UML 图表的开源工具。UML(Unified Modeling Language)是一种标准化的建模语言,用于描述和可视化软件系统的设计。PlantUML 允许通过简单的文本语法创建 UML 图表,而无需手动绘制图形。

# 2.PlantUML 作用是什么?

使用 PlantUML,您可以使用简单的文本描述来定义类图、时序图、用例图、活动图等多种 UML 图表类型。通过定义关键元素和它们之间的关系,PlantUML 将根据您的描述自动生成相应的图形表示。

# 二.简单语法

# 1.类图(Class Diagram)

@startuml
class Car {
  + speed: int
  + start()
  + accelerate()
  + brake()
}
@enduml
1
2
3
4
5
6
7
8

# 2.时序图(Sequence Diagram)

@startuml
Alice -> Bob: 请求
Bob --> Alice: 响应
@enduml
1
2
3
4

# 3.用例图(Use Case Diagram)

@startuml
actor User
usecase Login {
  + Main Page
}
User --> Login
@enduml
1
2
3
4
5
6
7

# 三.使用方式

# 1.下载插件

在插件市场搜索 PlantUML,可以看到如下图所示的插件,直接点击安装。

image-20231127154854593

# 2.新建 PlantUML 图

点击右键新建文件,可以看到一个新建 PlantUML File 的选项,通过点击可以生成一个 PlantUML 文件。

image-20231127155013066

# 3.文件命名

image-20231127155117335

# 4.效果展示

左侧是源码编辑区,右侧是预览图,可以看到生成的图片还是很美观的

image-20231127155156995

# 5.语法

@startuml
'https://plantuml.com/class-diagram

abstract class AbstractList
abstract AbstractCollection
interface List
interface Collection

List <|-- AbstractList
Collection <|-- AbstractCollection

Collection <|- List
AbstractCollection <|- AbstractList
AbstractList <|-- ArrayList

class ArrayList {
Object[] elementData
size()
}

enum TimeUnit {
DAYS
HOURS
MINUTES
}

@enduml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

# 四.图片无法展示

# 1.问题描述

新建 PlantUML 文件后,预览图如图所示。

image-20231127155335607

# 2.解决方案

安装 Graphviz

Graphviz 是一个开源的图形可视化软件,可以将结构信息表示为图形,应用于网络、生物信息学、软件工程、数据库和网页设计、机器学习等技术领域。

如果是 MAC,可以通过如下命令进行安装,其他系统,下载方式在这里 (opens new window)

brew install graphviz
1

# 3.如果无法安装

查看 brew 配置

brew config
1
#更改镜像源
echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.aliyun.com/homebrew/homebrew-bottles' >> ~/.zshrc

#是配置生效
vim ~/.zshrc
source ~/.zshrc
1
2
3
4
5
6
#继续安装
brew install graphviz

# 查看是否安装成功
brew info graphviz
1
2
3
4
5

# 4.unsupported dunno

如果出现如下错误

  • unknown or unsupported macOS version: :dunno (MacOSVersionError)

解决方案:

brew update-reset
1

# 5.查看 dot 的位置

# 查看是否安装成功
brew info graphviz
1
2

可以看到安装目录是 /opt/homebrew/Cellar/graphviz/9.0.0

image-20231127155817114

# 6.设置 dot 位置

在 idea 中配置 dot 的位置

/opt/homebrew/Cellar/graphviz/9.0.0/dot
1

image-20231127155950375

# 7.验证结果

可以看到已经生成了 PlantUML 生成的图片

image-20231127160022142

上次更新: 10/29/2024, 10:27:50 AM