PlantUML活动图进阶：泳道优化与活动分区技术

一、泳道基础与划分策略

泳道(Swimlane)是活动图中用于区分不同责任主体的垂直或水平区域，能直观展示业务流程中的角色分工。

1.1 垂直与水平泳道选择

@startuml
|垂直泳道示例|
start
:用户操作;
|系统|
:处理请求;
|数据库|
:持久化数据;
end

@startuml
left to right direction
泳道 水平示例 {
  start
  :用户操作;
}
泳道 技术支持 {
  :处理请求;
}
泳道 数据层 {
  :持久化数据;
}
@enduml

选择建议：

垂直泳道：适合角色较少（≤5个）且流程纵向发展的场景
水平泳道：适合角色较多或需要强调时间顺序的横向流程
超过7个泳道时考虑分层展示（如L1/L2级泳道）

二、跨泳道活动流转

跨泳道交互是业务流程的核心体现，PlantUML提供多种表达方式：

@startuml
|用户| -> |系统| : 提交订单
|系统| -> |支付网关| : 调用支付接口
|支付网关| --> |系统| : 返回支付结果
|系统| -> |物流系统| : 创建运单
@enduml

最佳实践：

使用->表示同步调用，-->表示异步响应
跨泳道消息应标注具体交互内容
复杂交互可配合序列图补充说明

三、泳道折叠与展开控制

大型流程图中可使用折叠功能保持可读性：

@startuml
hide empty swimlanes

|用户| {
  :登录系统;
  :浏览商品;
}

|订单系统| {
  fold
  :验证库存;
  :计算金额;
  :生成订单;
  end fold
}

|支付系统| {
  ...
}
@enduml

折叠策略：

fold/end fold：手动控制折叠区域
hide empty swimlanes：自动隐藏空泳道
对次要流程或已标准化的处理环节使用折叠

四、泳道视觉优化规范

4.1 颜色与命名规范

@startuml
skinparam swimlane {
  backgroundColor #F5F5F5
  borderColor #333333
  fontName Arial
}

|#LightBlue|前端| as front
|#LightGreen|业务逻辑| as service
|#LightYellow|数据层| as dao

front -> service : API调用
service -> dao : 数据查询
@enduml

配色建议：

按部门/系统分层设置色系（如运维-蓝色、业务-绿色）
关键路径使用高对比色（如红色警示流程）
命名采用「系统/角色+功能」格式（如"订单系统_支付模块"）

五、复杂案例：电商下单流程

@startuml
|#MistyRose|买家| as buyer
|#LightCyan|订单系统| as order
|#Honeydew|支付中心| as payment
|#Lavender|库存系统| as stock

buyer -> order : 提交订单
order -> stock : 库存预占(同步)
activate stock
stock --> order : 占用结果
deactivate stock

order -> payment : 发起支付(异步)
activate payment
payment --> buyer : 支付页面
buyer --> payment : 完成支付
payment --> order : 通知结果
deactivate payment

order -> stock : 确认扣减
@enduml

优化要点：

同步/异步调用使用不同箭头样式
激活标记(activate/deactivate)显示生命周期
泳道颜色区分业务域

六、常见问题解决方案

问题1：泳道过多导致混乱

方案：使用partition进行二级分组

partition "供应链域" {
|采购系统|
|仓储系统|
}

问题2：跨国流程时区差异

方案：泳道标注时区信息

|CN Team GMT+8| : 白天处理;
|US Team GMT-5| : 夜间批处理;

问题3：自动化与人工流程混合

方案：使用图标区分

|系统| : (S)自动审核;
|风控| : (M)人工复核;

掌握这些泳道优化技术后，可使复杂业务流程的表达清晰度提升50%以上。建议在实际项目中先进行泳道规划评审，再着手绘图实现。

PlantUML泳道优化与活动分区技术指南