Mermaid 报 Parse error 是什么意思,怎么改?
约 3 分钟 · 更新于 2026-09-13
Parse error 是语法没通过,不是图画错了。最常见的四个原因:用了保留字 end、箭头写串了、中文全角符号混进代码、节点文字里有没转义的引号。每种都有具体改法。
一句话答案
Parse error 是语法没解析通过,跟图画得对不对无关。在编辑器里报错会翻成中文并定位到具体行号,多数情况下是下面四种之一。
一、用了保留字 end
end 在 Mermaid 里是块结束标记,当节点文字会直接报错:
flowchart TD
A[开始] --> B[end]
改法:换个词(结束、完成),或者加引号 B["end"]。
二、箭头写法混用
同一张图里 -->、->、==> 混着写,或者少写一个短横线:
flowchart TD
A --> B
B -> C
改法:flowchart 里实线箭头统一写 -->。注意时序图(sequenceDiagram)用的是 ->>,两套语法不通用。
三、全角符号混进来
中文输入法下打出的 ()「」,: 会被当成非法字符。报错常指向一个看起来没问题的行——那多半是标点是全角的。改法:括号、冒号、逗号在代码结构位置必须是半角;节点文字里面用中文标点没问题。
四、节点文字里有引号或方括号
A[产品"新版"上线] 这种会把解析器截断。改法:整段用引号包起来 A["产品新版上线"],或者去掉内部符号。
四个坑都避开的样子
这段把上面四条都写对了,点「在编辑器里打开」对照着看:
flowchart TD
A[开始] --> B{金额超过 5000?}
B -- 是 --> C["总监审批(含附件)"]
B -- 否 --> D[主管审批]
C --> E([归档完成])
D --> E在编辑器里打开打开后可以改文字、换主题、下载 PNG / Word / PPT。
改完再看
编辑器里改完立刻重新渲染,报错条消失就是过了。实在看不出问题,报错条上有「AI 修复」——它只做最小改动把语法改通,改动会先给你看 diff 再决定要不要采纳。
还想知道
- 代码完全渲染不出来:看AI 给的 Mermaid 代码渲染不出来怎么办
- 各种报错的完整清单:看常见报错与改法