粘贴的代码有语法问题时，编辑器下方的报错条会用中文说明原因并标出行号，点「跳到第 N 行」直接定位；修好前预览保留上一次成功的图。报错条右侧还有「AI 修复」，采纳前会显示改动对比并先在本地校验。下面按报错条的提示逐条说。
连接线要写 -->，-> 不是 Mermaid 的箭头
流程图的连线是两根横线：A --> B。-> 只在时序图里出现（A->>B）。把这一行的 -> 改成 --> 即可。
end 是 Mermaid 的保留字
end 用来结束 subgraph、loop 等块，不能直接当节点名。改成 End、END，或者给它加标签：e1[end]。
括号没有闭合
[ 要配 ]，( 配 )，{ 配 }。最常见的情况是节点文字里本身有括号，例如 A[登录(手机号)]——把文字整体用双引号包起来：A["登录(手机号)"]。
这一行有全角符号
Mermaid 只认半角符号。语法位置上的 （）：，； 要改成 () : , ;。节点文字内部的中文标点没问题，只有充当语法的那几个要改。报错条会指出是哪个字符。
没识别出图表类型
第一行必须是图表关键字：flowchart TD、graph LR、sequenceDiagram、classDiagram、stateDiagram-v2、gantt、pie、mindmap 等。AI 有时会把关键字写在说明文字里而不是代码里，补上第一行即可。
subgraph 或分组块缺少 end
每个 subgraph、loop、alt、opt、par 都要有一行 end 收尾。行号会指到源码末尾，因为解析器读到文件结束还没等到 end。
消息行不完整
时序图的消息行要写全：A->>B: 消息内容。箭头后面必须跟参与者，冒号后面是消息文本。
关系符号不完整
ER 图的关系两端都要写基数，例如 USER ||--o{ ORDER : 拥有。||、o{、}| 这些符号缺一边就会报这条。
思维导图只能有一个根节点
思维导图靠缩进分层：第一行 mindmap，第二行是唯一的根 root((主题))，往下每一层比上一层多缩进两个空格。出现第二个顶格节点、或根节点缩得比分支还深，都会报这条，报错条会点名是哪个节点。多余的 end 行也会被当成第二个根。
图太大：连线超过 500 条
这不是语法错误，是渲染引擎的安全上限。把大图按模块拆成几张，或精简分支。这个规模的图在任何工具里都不适合放在一页。
反向连线不能带文字
A <-- 文字 --- B、A <-. 文字 .- B 这种「箭头在左边、中间带文字」的写法，语法检查能通过，但渲染引擎画不出来。把两端对调写成正向即可：B -- 文字 --> A（虚线写 B -. 文字 .-> A），箭头仍然指向 A。不带文字的 A <-- B、双向的 A <-->|文字| B 都没问题。报错条上的「一键修好」会自动对调。
linkStyle 的连线编号超出范围
linkStyle 3 stroke:red 里的 3 是第几条连线：从 0 开始，按代码里出现的顺序数。删掉或改动连线后，原来的编号可能就不存在了。删掉超出范围的编号即可；想统一设置所有连线，写 linkStyle default stroke:red。
分组和节点同名
subgraph A1[...] 里面又有一个节点叫 A1，或者分组里有一条连线连向分组自己，图里就形成了环。给分组换一个不重复的 id，例如 subgraph A1_组["标题"]。类图里 namespace 也不要和里面的类同名。
分组少了名字
subgraph [" "] 这样只写标题、不写 id 的分组，几个放在一起时渲染会失败。在方括号前面补一个 id：subgraph g1[" "]，每个分组的 id 不要重复。
甘特图日期读不出来
任务里的日期要和 dateFormat 写的格式一致，例如 dateFormat YYYY-MM-DD 配 2026-10-01。AI 回复里的日期有时用了看起来一样的特殊连字符（如 2026‑10‑01），要换成半角 -。
时序图激活配不上
A->>+B 里的 + 激活接收方 B，B-->>-A 里的 - 取消激活发送方 B，activate / deactivate 同理，要成对出现。AI 回复里常见激活了一个、取消的却是另一个，渲染就会失败。点「一键修好」会去掉配不上的 -，消息都保留，只少一段激活条。
这一行语法有误
以上都不是时的兜底提示，会带上出错位置附近的文本。常见原因：箭头、括号、引号不成对；节点文字里有 |、" 这类特殊符号（用双引号包住整段文字）；饼图 pie 每行要写成 "名称" : 数值。
这一行有无法识别的字符
一般是混入了特殊字符或不可见字符（从网页复制时偶尔会带上）。删掉这一行重打一遍，通常就好。
图表代码有语法错误
拿不到行号的兜底提示。检查箭头、括号与缩进；也可以直接点「AI 修复」。