Microsoft 的 Visual Studio Code 1.146 更新页面记录了截至 2026 年 11 月 13 日期间的一项文档工具变更：编辑器从 Mermaid 11 升级至 Mermaid 12。这项变更范围较小，但可能影响将渲染后的 Markdown 图表视为已评审工程产物的团队。
对于 CTO 和工程领导者而言，信号很明确：捆绑图表库升级应纳入文档测试计划。这不仅是版本标签的变化，更是渲染依赖项的变化，可能影响预览一致性、审批和发布工作流。
1. Mermaid 12 替换 Mermaid 11
它是什么
Microsoft 的 Visual Studio Code 更新页面直接展示了这一转换：
| 之前 | 之后 |
|---|---|
Mermaid 11 | Mermaid 12 |
根据 Microsoft 的发行记录，Visual Studio Code 1.146 的稳定版本于 2026 年 11 月 11 日 发布。Mermaid 提供常嵌入 Markdown 的文本定义图表，而 Visual Studio Code 将 Mermaid 渲染集成到其 Markdown 相关工具中。
因此，此次更新改变了编辑器集成图表工作流所使用的主版本。升级编辑器的开发人员将获得新的主版本，无需为该内置体验单独安装 Mermaid。
Mermaid 针对 12.3.0 的发行信息描述了若干新增功能，包括 BPMN 元素形状、开放箭头和空心圆边缘标记，以及可选的流程图边缘动画。这些上游功能为 Mermaid 12 产品线提供了背景信息，但在 Microsoft 指明所捆绑的次版本之前，团队不应将每项 12.3.0 功能视为已在 Visual Studio Code 中得到确认。
为什么重要
重大渲染库变更可能改变现有图表的呈现方式，即使其源文本保持不变。布局、间距、连接线、标签和样式，都是架构图和运维文档的评审面。
这并不是阻止更新的理由，而是测试重要产物的理由。
为什么这很重要： 团队通常在编写图表时使用 Visual Studio Code 预览，然后通过独立的文档生成器或持续集成管道渲染相同文件。如果这些环境使用不同的 Mermaid 主版本，编辑器预览可能不再与已发布结果一致。
对于受监管行业而言，文档一致性是一项治理要求。在一个渲染环境中获批的图表，不应在另一个环境中悄然生成存在重大差异的输出。
扩展作者还需要区分 Visual Studio Code 的集成 Mermaid 支持与其自身扩展所打包的 Mermaid 依赖项。更新编辑器并不意味着每个支持 Mermaid 的扩展或外部渲染器都已迁移到相同版本。
也许最关键的问题是版本一致性。如果编辑器预览、拉取请求检查和发布系统通过不同 Mermaid 版本渲染同一图表，团队可能会将评审时间花在调查输出差异上，而非内容变更。
Agent-first 开发或许是现代开发工具更广泛的发展方向，但文档依赖项仍需要传统的发布纪律。渲染一致性仍是一项工程控制措施。
核心结论
Visual Studio Code 1.146 将其集成图表工具从 Mermaid 11 推进至 Mermaid 12。Microsoft 确认了主版本转换，但更新条目并未说明确切的 Mermaid 12 次版本或补丁版本。
这对企业团队意味着：
建立基线。 在广泛部署 Visual Studio Code
1.146前，捕获具有代表性的业务关键 Mermaid 图表的当前输出。比较渲染输出。 更新后评审布局、标签、连接线、颜色和可读性，而不是仅依赖成功解析。
检查发布路径。 确定文档生成器和持续集成作业使用的是 Mermaid 11、Mermaid 12 还是其他渲染器。
区分已确认支持与上游可用性。 不要仅依据 Microsoft 对
Mermaid 12的确认，就承诺支持12.3.0特定功能。记录已接受的差异。 如果新渲染器改变了已批准的图表，请在更新后的输出进入生产文档前记录该决策。
祝编码愉快！