经验分享Mermaid流程图时序图UML文档协作
以前开评审会,经常吵在“图到底是不是这么走”。每个人脑子里的流程都不一样,图也改来改去,最后谁也说不清谁。后来我们统一把图改成 Mermaid 文本,讨论也变了味道:从“样式”转到了“语义”,PR 里直接能看到改动的行。
我自己的体会是,写 Mermaid 不需要很复杂的语法。大部分时候就是流程图和时序图,偶尔补一个状态图或 ER。在线编辑器的模板够用,实时预览很直观,导出 SVG/PNG 都方便。重点是给团队定几个约定:主题一致、命名规则清楚、复杂流程拆成子图,别在一张图里塞满所有细节。
自从这么做,评审效率高了很多。以前纠结“箭头画得好不好看”,现在直接看“这里到底是不是必经路径”;以前一张图反复截图粘贴,现在提交一段文本就行。该怎么走,改哪里,大家心里更有数。