引言

PlantUML 类图描述系统的静态结构:包括类、属性、操作和关系。您编写文本规范并将其渲染为图表,使源代码易于编辑并纳入版本控制。
1. 最小化图表
类图以@startuml开始,以@enduml:

@startuml
class User
class Order
User --> Order : places
@enduml
PlantUML 可以从关系声明中推断类,但显式声明类会使大型图表更易于扫描和维护。
2. 类、属性和方法
将属性和操作放在花括号内。冒号用于分隔成员名称与其类型;括号用于标记操作。

@startuml
class User {
-id: int
-email: String
+login(password: String): boolean
+logout(): void
}
@enduml
可见性标记包括:
-
+public -
-private -
#protected -
~包私有
您也可以将类型写在成员名称之前——例如,+String email 或 +void logout()。PlantUML 同时支持熟悉的类代码风格的成员表示法以及这些可见性标记。
静态成员和抽象成员
使用 {static} 或 {classifier} 表示静态成员,而 {abstract} 表示抽象成员:

@startuml
抽象类 PaymentMethod {
{abstract} +authorize(amount: Decimal): boolean
{static} +supportedCurrencies: String[]
}
类 CardPayment {
+authorize(amount: Decimal): boolean
}
PaymentMethod <|-- CardPayment
@enduml
抽象类也可以使用以下关键字声明:abstract class.
3. 关系
箭头形状表示关系类型。线条的方向由名称的顺序决定;请使用标签来阐明其含义。
| 关系 | PlantUML 符号 | 典型含义 |
|---|---|---|
| 继承 / 泛化 | `Parent < | — Child` |
| 接口实现 | `Interface < | .. Class` |
| 组合 | 整体 *-- 部分 |
部分的生命周期由整体拥有 |
| 聚合 | 整体 o-- 部分 |
整体分组或引用可以独立存在的部分 |
| 定向关联 | A --> B |
A 对 B 具有可导航的关系 |
| 依赖 | A ..> B |
A 使用或依赖于 B |
这些是 PlantUML 的标准关系符号。

@startuml
interface Repository
class SqlRepository
class OrderService
class Order
class OrderLine
Repository <|.. SqlRepository
OrderService ..> Repository : uses
Order *-- "1..*" OrderLine : contains
@enduml
请仔细选择:组合和聚合表达了不同的生命周期语义。仅当部分被整体有意义地拥有时才使用组合;当两种所有权解释都不适用时,请使用普通关联。
4. 多重性、角色名称和标签
多重性指定了在关联的两端可能参与的对象数量。常见形式包括"1", "0..1", "*"、和"1..*".

@startuml
class Customer
class Order
Customer "1" --> "0..*" Order : places
@enduml
在此,每个订单与一个客户,而一个客户可以下零个或多个订单。从另一端读取多重性:靠近”的数字订单描述了可以与一个客户关联的订单数量。
为了更高的精确度,请添加角色名称或约束条件:

@startuml
class Team
class Player
Team "1" o-- "0..*" Player : members
note on link
球员可以在球队之间转会。
end note
@enduml
5. 接口、枚举、构造型和包
PlantUML 支持如下声明:接口, 枚举, 抽象类以及写在”和”之间的构造型<<和>>.

@startuml
package "Ordering" {
interface PaymentGateway {
+charge(amount: Decimal): PaymentResult
}
enum OrderStatus {
NEW
PAID
CANCELLED
}
class Order <<Entity>> {
+id: UUID
+status: OrderStatus
}
class CheckoutService <<Service>> {
+checkout(order: Order): PaymentResult
}
CheckoutService ..> PaymentGateway : calls
Order --> OrderStatus
}
@enduml
包在视觉上对相关类型进行分组。使用诸如“<<实体>>” 或“<<服务>>” 当它们能提供有用的上下文时使用;避免添加仅重复类名已有信息的标签。
6. 注释、别名和布局
注释可以解释设计决策或阐明约束,而无需让类名过于冗长。当显示的名称包含空格或标点符号时,别名会有所帮助。

@startuml
class "外部支付 API" as PaymentApi
class CheckoutService
CheckoutService ..> PaymentApi : 提交支付
note right of CheckoutService
重试临时性失败。
不重试被拒绝的支付。
end note
left to right direction
@enduml
从左到右的方向 可更改整体布局方向;默认方向为从上到下。您还可以使用关系方向,例如“-左->” 或“-上-|> 来引导局部布局。
7. 更完整的示例
此示例结合了可见性、类型、方法、枚举、多重性、组合和依赖关系:

@startuml
left to right direction
package "销售" {
class Customer {
-id: UUID
+name: String
+placeOrder(): Order
}
class Order {
-id: UUID
-status: OrderStatus
+addLine(product: Product, quantity: int): void
+total(): Decimal
}
class OrderLine {
-quantity: int
+lineTotal(): Decimal
}
class Product {
+sku: String
+price: Decimal
}
enum OrderStatus {
NEW
PAID
CANCELLED
}
interface PaymentGateway {
+charge(amount: Decimal): PaymentResult
}
class CheckoutService {
+checkout(order: Order): PaymentResult
}
Customer "1" --> "0..*" Order : 下订单
Order *-- "1..*" OrderLine : 包含
OrderLine "*" --> "1" Product : 引用
Order --> OrderStatus
CheckoutService ..> PaymentGateway : 使用
}
@enduml
8. 工具:Visual Paradigm VPasCode
VPasCode 是 Visual Paradigm 推出的一款基于浏览器的文本转图表编辑器。它支持 PlantUML 类图,并提供带有实时预览的代码编辑器,让您能够编写或粘贴 PlantUML 代码,并在编辑过程中即时查看渲染结果。

典型工作流程:
-
打开 VPasCode,选择 PlantUML 编辑器或一个 PlantUML 示例。
-
将示例文本替换为您的图表,包括
@startuml和@enduml. -
检查实时预览;如果渲染失败,请查看高亮显示的语法错误及其所在行。
-
优化图表,然后根据需要进行导出或分享。VPasCode 支持 SVG、PNG 和 PDF 格式的导出选项。
VPasCode 还提供 PlantUML 的主题选择界面,包括 Visual Paradigm 和 Rose 主题。为确保团队内结果的一致性,请将 PlantUML 源代码与您的文档或代码一起保存,而不要仅依赖导出的图片。
9. 常见陷阱与最佳实践

-
不要将关联(association)与依赖(dependency)混淆。依赖通常表示“使用”;而关联往往代表一种更持久的结构性关系。
-
避免过度使用组合(composition)。它比简单的连接具有更强的生命周期主张。
-
从另一端标注多重性。某一类旁边的数字表示该类的一个实例可能与另一端多少个实例相关联。
-
保持图表聚焦。将非常大的模型拆分为包或针对不同关注点的独立图表。
-
展示服务于受众的细节。概念性概览可能只需类名和关系;而设计级图表可能需要类型、可见性和操作。
-
将源代码视为需要维护的工件。审查文本的变更,在编辑后重新渲染,并在源代码发生变化时重新生成导出文件。
快速参考

@startuml
class A {
+publicField: String
-privateField: int
#protectedMethod(): void
~packageMember(): boolean
}
interface I
abstract class Base
enum State { READY; DONE }
Base <|-- A
I <|.. A
A *-- B : composition
A o-- C : aggregation
A --> D : association
A ..> I : dependency
@enduml
当图表需要进一步细化时,PlantUML 支持额外的类图功能,包括成员分组、注释、颜色等。










