我用AI写Mermaid，差点被逼疯！一个连Gemini都搞不定的“史诗级”排错之旅

在AI席卷一切的今天，我们的工作流似乎被重塑了：遇到问题，写个Prompt，让AI生成代码。我本以为用Mermaid画个思维导图也是如此，直到我一脚踏进了一个连Gemini这种顶级大模型都束手无策的"天坑"。

这不仅是一次排错，更是一场关于AI的局限、老码农的直觉和官方文档重要性的深刻体验。

我的需求很简单：将一份操作手册整理成思维导图。我熟练地打开Gemini，喂给它我的需求，它也"不负众望"，迅速生成了一份看起来非常专业的Mermaid代码。

Code snippet

scss 复制代码

mindmap
  智能体开发实战操作手册
    第二阶段：能力构建
      步骤
        - "叫作"专家角色" (Role-Playing)" 
        - "搏出"元问题" (Meta-Questioning)"

我自信地将代码贴入编辑器，等待着惊艳的图表出现。然而，现实却给了我一记响亮的耳光------Parse error。

"小问题，"我想，"AI偶尔会犯错。" 我将完整的报错信息和代码一并扔回给Gemini，让它修正。

它道歉，然后给出了修改版。我粘贴，运行，依旧报错！

我再次把新的报错信息贴给它，它再次道歉，再次修改......这个过程循环了三四次，我们始终围绕着代码的结构打转，但Gemin始终没能意识到问题的根源。它陷入了一个逻辑怪圈，无法理解为什么这段"看起来没问题"的代码就是通不过。

此时我意识到， AI 已经到了它的能力边界。 它能理解通用的语法规则，但对这种特定工具的"怪癖"和深层Bug却无能为力。

是时候放弃幻想，靠自己了！这才是"老码农"的看家本领：直觉、手动测试和查阅官方文档。

我决定采用最朴素的"控制变量法"。当我试着把节点后面的 (Role-Playing)、(MVP) 这些括号和里面的内容全部删掉时，奇迹发生了------程序不再报错了！

【重大发现1】 ：导致程序崩溃的"元凶"是英文括号 () ！为了进一步验证，我做了个大胆的尝试：把英文括号换成中文括号 （） ，结果竟然也成功了！

【真相】 ：这背后的原理是，英文括号 () 对Mermaid解析器是**"命令符号" ，有特殊的语法含义，错误的使用会引发冲突。而 中文括号 （）** 对它来说只是**"普通文字"**，因此能被安全地渲染。

解决了崩溃问题，我松了一口气，图表总算出来了。但仔细一看，不对劲！有些节点的内容，比如"识别问题信号"，竟然是空的！文字"凭空消失"了。

(注：此处用最终成功的图示意，但可想象部分节点是空心的)

这次没有任何报错，问题变得更加隐蔽。我的直觉告诉我，问题出在剩下的"特殊符号"上------子节点前的连字符 -。

经过反复测试，我最终确认：

【重大发现2】 ：使用 - 作为子节点的缩进前缀，是导致不稳定的另一个核心原因 。它不仅可能引发解析错误，还存在一个更诡异的"幽灵Bug"：在某些情况下，代码不报错，但该节点的文本就是渲染不出来！

这让我下定决心，必须彻底抛弃 - 写法，完全依靠纯粹的缩进。

这次坎坷的经历，让我对AI和个人技能有了全新的思考。AI可以给我们一个90%的起点，但解决最后10%最棘手、最关键的问题，往往还是要靠我们自己那份源于经验的直觉、刨根问底的耐心和尊重第一手资料（官方文档）的习惯。

最后，给所有使用Mermaid的朋友们献上我用"血泪"换来的最佳实践：

希望我的这段经历，能让你在AI时代更加相信自己手中那份不可替代的价值。这或许就是作为一名工程师，最独特的乐趣和骄傲所在。