跳到主要内容

architectural-diagrams

架构图能帮助您更好地理解系统的工作原理。您可以用它们来梳理逻辑、追踪数据并沟通结构。Cursor 支持直接使用 Mermaid 等工具生成这些图表，只需几个提示词就能将代码转化为可视化图表。

架构图示例

图表的重要性​

图表能够清晰地展现数据如何流动以及各组件之间如何交互。在以下场景中尤其有用：

  • 需要理解代码库中的流程控制
  • 需要追踪从输入到输出的数据血缘
  • 进行新人培训或系统文档编写

它们也是调试和提出更智能问题的利器。可视化图表能帮助您（以及 AI 模型）更全面地把握整体架构。

需要考虑的两个维度​

可以从以下几个角度进行分析：

  • 目的：您是在梳理逻辑、数据流、基础设施，还是其他内容？
  • 格式：需要快速草图（如 Mermaid 图表）还是正式文档（如 UML 图）？

如何编写提示词​

首先明确目标。以下是几种常见的提问方式：

  • 流程控制："展示请求如何从控制器传递到数据库"
  • 数据溯源："追踪这个变量从输入到最终输出的完整路径"
  • 结构分析："提供该服务的组件级视图"

您可以指定起点和终点，或要求 Cursor 自动发现完整路径。

使用 Mermaid 绘图​

Mermaid 语法简单易学，可直接在 Markdown 中渲染（需安装对应扩展）。Cursor 能够生成以下类型的图表：

  • flowchart 逻辑流程图
  • sequenceDiagram 时序图
  • classDiagram 类结构图
  • graph TD 简单方向图