如何使用PlantUML调整协作图中对象的布局位置？

需求与问题 #

想要创建一张协作图，目标布局为：Operator、SMDP+、HSS横向排列，Subscriber位于Operator正下方；但现有PlantUML代码渲染的布局混乱，尝试Graphviz效果更差，需要调整布局实现目标样式。

当前代码 #

@startuml
actor "Operator" as op
actor "Subscriber" as sub
node "HSS" as hss
node "SMDP+" as smdp

op -right-> smdp : 1: Place profile order
smdp -> op : 2: Return provisioning data
op -right-> hss : 3: Provision profile data
op -down-> sub : 4: Provide download info
sub -[norank]> smdp : 5: Request download
hss -[hidden]down-> smdp
@enduml

调整思路与修改后代码 #

通过PlantUML的布局控制指令可以精准调整节点位置，以下是可行方案：

@startuml
left to right direction  # 强制整体横向布局

# 先定义横向排列的角色/节点，确保Operator、SMDP+、HSS在同一水平线上
actor "Operator" as op
node "SMDP+" as smdp
node "HSS" as hss

# 使用||分隔符切换到垂直布局，将Subscriber放在Operator下方
||
actor "Subscriber" as sub

# 绘制流程连线，调整箭头方向与标记
op -> smdp : 1: Place profile order
smdp -> op : 2: Return provisioning data
op -> hss : 3: Provision profile data
op -> sub : 4: Provide download info
sub -> smdp : 5: Request download
@enduml

关键调整说明 #

• left to right direction：强制初始布局为横向，让Operator、SMDP+、HSS自动水平排列
• ||分隔符：用于切换布局上下文，将后续定义的Subscriber节点放在前一组节点的垂直下方，默认对齐第一个节点（Operator）
• 移除不必要的hidden连线和norank标记，让PlantUML根据布局规则自动处理连线顺序

内容的提问来源于stack exchange，提问作者Ron McLeod