常见报错怎么改

更新于 2026-09-02

粘贴的代码有语法问题时，编辑器下方的报错条会用中文说明原因并标出行号，点「跳到第 N 行」直接定位；修好前预览保留上一次成功的图。报错条右侧还有「AI 修复」，采纳前会显示改动对比并先在本地校验。下面按报错条的提示逐条说。

连接线要写 -->，-> 不是 Mermaid 的箭头

流程图的连线是两根横线：A --> B。-> 只在时序图里出现（A->>B）。把这一行的 -> 改成 --> 即可。

end 用来结束 subgraph、loop 等块，不能直接当节点名。改成 End、END，或者给它加标签：e1[end]。

[ 要配 ]，( 配 )，{ 配 }。最常见的情况是节点文字里本身有括号，例如 A[登录(手机号)]——把文字整体用双引号包起来：A["登录(手机号)"]。

Mermaid 只认半角符号。语法位置上的 （）：，； 要改成 () : , ;。节点文字内部的中文标点没问题，只有充当语法的那几个要改。报错条会指出是哪个字符。

第一行必须是图表关键字：flowchart TD、graph LR、sequenceDiagram、classDiagram、stateDiagram-v2、gantt、pie、mindmap 等。AI 有时会把关键字写在说明文字里而不是代码里，补上第一行即可。

每个 subgraph、loop、alt、opt、par 都要有一行 end 收尾。行号会指到源码末尾，因为解析器读到文件结束还没等到 end。

时序图的消息行要写全：A->>B: 消息内容。箭头后面必须跟参与者，冒号后面是消息文本。

ER 图的关系两端都要写基数，例如 USER ||--o{ ORDER : 拥有。||、o{、}| 这些符号缺一边就会报这条。

思维导图靠缩进分层：第一行 mindmap，第二行是唯一的根 root((主题))，往下每一层比上一层多缩进两个空格。出现第二个顶格节点、或根节点缩得比分支还深，都会报这条，报错条会点名是哪个节点。多余的 end 行也会被当成第二个根。

这不是语法错误，是渲染引擎的安全上限。把大图按模块拆成几张，或精简分支。这个规模的图在任何工具里都不适合放在一页。

以上都不是时的兜底提示，会带上出错位置附近的文本。常见原因：箭头、括号、引号不成对；节点文字里有 |、" 这类特殊符号（用双引号包住整段文字）；饼图 pie 每行要写成 "名称" : 数值。

一般是混入了特殊字符或不可见字符（从网页复制时偶尔会带上）。删掉这一行重打一遍，通常就好。

拿不到行号的兜底提示。检查箭头、括号与缩进；也可以直接点「AI 修复」。