系统分析师实测：PlantUML凭什么赢过Mermaid！
内容提要
PlantUML与Mermaid之争：Mermaid上手快、生态强，但布局控制差，无法局部调整间距或颜色，嵌套激活渲染混乱；PlantUML虽需配置，但精确控制细节，适合复杂时序图。新工具D2布局佳但生态弱。作者认为工具应助人而非替人决策，专业场景下PlantUML更可靠。
延伸解读
布局控制：局部调整与全局影响的博弈
文章指出，Mermaid在时序图中无法局部调整间距或颜色，只能通过全局参数或HTML hack实现，导致“给一棵树浇水却淹了整片森林”。而PlantUML通过简单的`|||`语法即可精准控制空行位置，体现了渲染引擎“听懂人话、指哪打哪”的基本素养。这种差异反映了工具设计哲学：是让用户精细控制，还是让引擎自动决策。对于需要精确表达复杂逻辑的系统分析师而言，局部控制能力至关重要。
视觉定制：颜色即语义的传达工具
文章强调，系统分析师常用颜色传递语义信息，如用浅红色标记错误处理流程，以增强图的可读性。Mermaid仅支持全局主题，无法单独为元素着色，限制了这种信息传达方式。而PlantUML的skinparam系统允许用户自由调整颜色、字体等细节，将控制权交还用户。这提醒读者，在选择图表工具时，需考虑视觉定制能力是否满足专业场景下的信息表达需求。
嵌套激活：复杂逻辑的清晰呈现
嵌套激活是时序图中表示多层调用关系的关键，Mermaid在此场景下渲染混乱，箭头位置错误、激活框错位，导致图难以理解。PlantUML则能准确渲染嵌套框和箭头，确保“你写什么，它渲染什么”。文章通过实际案例说明，一张图应消灭解读空间，而非制造歧义。对于涉及复杂调用关系的系统设计，工具的渲染准确性直接影响沟通效率。
生态与专业度的权衡
文章承认Mermaid在生态上具有碾压优势，如GitHub原生渲染、广泛平台支持，但指出其定位是“轻量级、够用就好”，开发者可能不会优先优化复杂时序图功能。PlantUML虽需额外配置，但专业度更高。新工具D2布局质量佳但生态薄弱。这提示读者，选择工具需权衡生态便利性与专业功能，根据使用场景（如README流程图 vs 复杂系统时序图）做出取舍。
Q&A
PlantUML和Mermaid在布局控制上有什么主要区别？
Mermaid的布局控制能力较弱，无法局部调整间距或颜色，只能通过全局参数或HTML hack来弥补；而PlantUML允许精确控制细节，例如在需要加空行的位置使用`|||`，并能通过skinparam系统自定义颜色、字体等。
Mermaid在嵌套激活渲染上存在哪些问题？
Mermaid在处理嵌套激活时会出现渲染混乱，例如自调用时箭头从激活框外部射入而非内部，deactivate可能错误地创建新框，箭头可能插在错误的层级上，导致图表难以理解。
为什么系统分析师更倾向于使用PlantUML？
因为PlantUML提供精确的布局控制和视觉定制能力，能够准确表达复杂的时序图，如嵌套激活、错误处理分支等，而Mermaid的渲染引擎会替用户做决定，导致图表信息不准确。
Mermaid的生态优势体现在哪些方面？
Mermaid支持GitHub原生渲染，无需插件即可在README中显示图表，并得到Notion、Obsidian、GitBook等众多平台支持，甚至可以在ChatGPT中直接生成。
D2工具的特点和不足是什么？
D2的布局质量高，默认效果干净，但图表类型覆盖窄，生态年轻，编辑器插件少，且嵌入Confluence等平台较为困难。
作者认为工具应该扮演什么角色？
作者认为工具应该帮助人工作，而不是替人做决策。Mermaid的渲染引擎替用户决定布局和样式，而PlantUML将控制权交还给用户，让用户决定如何绘制图表。
