PlantUML活动图添加partition如何保留原有元素宽度与排版

问题描述 #

• 现有包含大量分支的大型PlantUML活动图，需要在图中标注归属于特定微服务的流程区段
• 添加partition语法后，所有元素被挤压排布、连线交叉错乱，进一步降低了复杂图表的可读性
• 查阅官方文档未找到设置partition宽度的相关配置，尝试使用swimlanes（泳道）实现效果未生效，判断泳道功能不适用于该活动图场景
• 因业务代码涉密，使用以下模拟代码复现问题：

@startuml
skinparam backgroundColor Azure

"user clicks on link" --> "do something"

"do something" --> ===b1===
===b1=== --> "do somethin else"
===b1=== --> "yep"
"yep" --> "foobarbaz"
"do somethin else" --> "bizzfuzz"
"bizzfuzz" --> ===b2===
"foobarbaz" --> ===b2===
partition Conductor{

    if "is it it" then 
    --> ["yes it's it"] "OK"
        if "really?" then 
        -->"asdfasdfasdfasdfasdf"
        else
        -->"asdfasdffasdfasdf"
            if "sure?" then 
            -->"zxcvzxcv"
            else
            -->"zxcv"

            endif
        endif
    else 
        -->"do something different"
        if "asdf?" then 
            -->"ghasdgf"
            else
            ->"asdf"
                if "reallysure?" then 
                -->"ireytiteryi"
                else
                -->"wertywert"
                endif
            endif
}

@enduml

对应渲染效果示例：

移除partition后元素会保持更宽松的排布间距，需求为：添加微服务边界标注的同时，保留元素原有的宽松排布宽度，避免挤压错乱。

解决方案 #

PlantUML没有提供直接设置partition宽度的配置项，可通过以下三种方案实现需求，按改造成本从低到高排序：

1. 调整布局间距参数抵消压缩效应 #

在文件开头添加skinparam配置，拉大节点、分区的内外边距，抵消partition带来的默认压缩效果，参考配置：

skinparam activity {
  ' 节点与连线的外边距
  Margin 18
  ' 节点内部文字与边框的内边距
  Padding 22
}
skinparam partition {
  ' 分区边界与内部元素的留白
  Padding 30
}

可根据实际图的大小调整数值，不需要修改原有流程逻辑，改造成本最低。

2. 添加透明隐形节点撑开局部空间 #

如果调整全局参数后仍有局部分支挤压，可在分区内挤压位置的两侧添加透明隐形节点，布局引擎会将其识别为有效元素自动撑开空间，且隐形节点不会在最终渲染图中显示，示例写法：

partition Conductor{
  ' 左侧隐形撑宽节点
  -[#transparent]-> " " as left_pad
  ' 原有流程逻辑
  if "is it it" then 
  --> ["yes it's it"] "OK"
  ' ... 其余原有流程节点
  ' 右侧隐形撑宽节点
  -[#transparent]-> " " as right_pad
}

3. 用自定义矩形替换原生partition #

如果图的分支层级过深，前两种方案调整后仍有连线交叉问题，可直接放弃原生partition语法，改用自定义矩形标注服务边界。矩形不会触发分区专属的压缩布局逻辑，内部元素会保持和无分区时一致的宽松排布，同时视觉上和partition的边界标注效果几乎无差异，示例写法：

' 流程逻辑保持不变，仅将partition替换为自定义矩形
rectangle "**Conductor**" #Azure;line:Gray {
    if "is it it" then 
    --> ["yes it's it"] "OK"
        ' ... 其余归属该微服务的流程节点
}

泳道不生效原因说明 #

PlantUML活动图的泳道语法要求从流程起始就按泳道做全链路拆分，不支持给流程中途的某一段单独添加泳道，因此不适用于仅标注部分区段微服务归属的场景。

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