如何修正PlantUML中线条的不合理绕行路径？

解决PlantUML连线绕路问题的几种实用方法 #

1. 用隐藏中转节点强制路径走向 #

这是最直接控制连线路径的方法——添加一个隐藏节点作为中转，让连线先向右走到这个节点，再垂直向下连接到目标，完全按照你想要的路径走：

left to right direction
actor "Customer" as Customer
rectangle "Order Service" {
  (Place Order) as PO
  (Cancel Order) as CO
}
rectangle "Notification Service" {
  (Publisher) as Pub
}
' 新增隐藏节点，放在对应操作的右侧
node [hidden] as H_PO right of PO
node [hidden] as H_CO right of CO

Customer --> PO
Customer --> CO
PO -right-> H_PO -down-> Pub
CO -right-> H_CO -down-> Pub

2. 切换布局引擎或方向 #

PlantUML默认用dot布局引擎，有时候它会自动优化路径导致绕路。你可以试试切换成neato引擎，或者调整整体布局方向：

示例1：切换为neato引擎

@startuml
!pragma layout neato
left to right direction
actor "Customer" as Customer
rectangle "Order Service" {
  (Place Order) as PO
  (Cancel Order) as CO
}
rectangle "Notification Service" {
  (Publisher) as Pub
}

Customer --> PO
Customer --> CO
PO -> Pub : right,down
CO -> Pub : right,down
@enduml

示例2：改为从上到下布局

如果横向布局容易出问题，改成垂直布局后连线逻辑会更清晰：

top to bottom direction
actor "Customer" as Customer
rectangle "Order Service" {
  (Place Order) as PO
  (Cancel Order) as CO
}
rectangle "Notification Service" {
  (Publisher) as Pub
}

Customer --> PO
Customer --> CO
PO -right-> Pub
CO -right-> Pub

3. 用路径标记明确分段 #

PlantUML支持用|标记强制水平/垂直段，直接告诉渲染器你要的路径：

left to right direction
actor "Customer" as Customer
rectangle "Order Service" {
  (Place Order) as PO
  (Cancel Order) as CO
}
rectangle "Notification Service" {
  (Publisher) as Pub
}

Customer --> PO
Customer --> CO
' 用|right|强制先水平向右，再自动垂直连接
PO -->|right| Pub
CO -->|right| Pub

4. 手动调整组件相对位置 #

如果组件的默认布局位置是根源，可以直接指定目标组件的位置，比如把Notification Service放在Order Service的右下方：

left to right direction
actor "Customer" as Customer
rectangle "Order Service" as OS {
  (Place Order) as PO
  (Cancel Order) as CO
}
rectangle "Notification Service" as NS {
  (Publisher) as Pub
}
' 手动指定NS的位置
NS right of OS
NS down of OS

Customer --> PO
Customer --> CO
PO -> Pub
CO -> Pub

如果这些方法还没解决你的问题，可以把你的具体PlantUML代码贴出来，我再帮你做更精准的调整~

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