AI 给的 Mermaid 代码渲染不出来怎么办？

一句话答案

把代码粘进编辑器，底部状态行会变成中文报错条并指出第几行。按报错内容分三种情况处理。

情况一：语法错（最常见）

报错里出现 Parse error、Lexical error 的，是语法问题。AI 生成的代码有四个高频坏点：保留字 end、箭头写法混用、全角标点、节点文字里的引号。每种的改法在Parse error 怎么改里逐条写了。

不想自己找的话，报错条上有「AI 修复」：它把当前代码发给引擎处理一次，只做最小改动，返回后先在本地验证能不能渲染，再用逐行 diff 给你看改了哪里，你决定采纳还是放弃。

情况二：语法是新版的，或者干脆不是 Mermaid

有些模型会给出更新版本才支持的写法，也有的会把别的图表语言（PlantUML、Graphviz 的 dot）当成 Mermaid 给你。判断方法：第一行是不是 flowchart / graph / sequenceDiagram / classDiagram / stateDiagram-v2 / erDiagram / mindmap / gantt / pie 这些开头。都不是，就是拿错语言了，回去让 AI「用 Mermaid 语法重写」。

情况三：图太大

流程图的连线超过 500 条会被引擎直接拒绝，报错说的是上限不是语法错。这种只能拆图：按阶段拆成几张，或者把明细层折叠掉。三百个节点左右的图渲染要一秒上下，属于正常。

试一下正常的样子

stateDiagram-v2
    [*] --> 待支付
    待支付 --> 已支付: 支付成功
    待支付 --> 已取消: 超时 30 分钟
    已支付 --> 已发货: 仓库出库
    已发货 --> 已完成: 用户确认收货
    已完成 --> [*]

还想知道

• Parse error 是什么意思，怎么改
• 改字与修报错