这是 Mermaid 语法，专门用来在 Markdown 里画流程图，很多平台支持：Typora、语雀、飞书文档、Gitlab、Github、Notion、Trae/VSCode 插件等

你这段是 graph TD，TD = Top Down，从上到下的流程图

基础语法速记

graph TD
    起点 --> 终点       // 箭头连线
    节点ID["显示文字"]  // 方框节点，最常用
    节点ID(圆角文字)    // 圆角框
    节点ID{判断}        // 菱形判断框

graph TD：从上往下
graph LR：从左往右（LR=Left Right，后端架构图最常用）

拆解你这段代码

graph TD
    A["跑腿员端 API (api/errand)"] --> S1["ErrandCourierService"]
    A --> S2["ErrandOrderService"]
    B["管理平台 API (admin/errand)"] --> S1
    B --> S3["ErrandCarrierService"]
    C["用户端下单 (api ErrandController)"] --> S2
    S3 --> M["CarrierManager (运力解析)"]
    M --> I["CarrierInterface"]
    I --> R1["SelfCourierCarrier (自有骑手)"]
    I --> R2["ThirdPartyCarrier (UU/闪送 预留)"]
    S2 --> L["ErrandOrderStatusLog / ErrandTimeNode / ErrandWorkRecord"]

• A、S1、S2：是节点唯一ID，随便起名，只用来内部连线，不展示
• ["xxx"]：方括号，矩形框，显示里面的文字
• -->：单向箭头，表示依赖/调用关系（A 调用 S1）

快速上手规则（记住4条就够用）

1. 开头固定：graph TD（竖向）或者 graph LR（横向，推荐画架构）
2. 每个节点格式：ID["展示文本"]，ID不能重复
3. 连线：ID1 --> ID2
4. 一行一条连线，换行不影响

改成横向架构图版本（后端结构图一般用LR更好看）

graph LR
    A["跑腿员端 API (api/errand)"] --> S1["ErrandCourierService"]
    A --> S2["ErrandOrderService"]
    B["管理平台 API (admin/errand)"] --> S1
    B --> S3["ErrandCarrierService"]
    C["用户端下单 (api ErrandController)"] --> S2
    S3 --> M["CarrierManager (运力解析)"]
    M --> I["CarrierInterface"]
    I --> R1["SelfCourierCarrier (自有骑手)"]
    I --> R2["ThirdPartyCarrier (UU/闪送 预留)"]
    S2 --> L["ErrandOrderStatusLog / ErrandTimeNode / ErrandWorkRecord"]

怎么运行预览

VSCode 装插件：Markdown Preview Mermaid Support，打开md直接看；
飞书/语雀文档，直接粘贴这段代码，选择Mermaid代码块即可渲染。

扩展小补充（你画架构常用）

• 虚线箭头：-.->

• 标注文字箭头：A -- 调用 --> B

  graph LR
  A["服务A"] -- 同步调用 --> B["服务B"]
  B -.-> C["异步回调"]

版权属于：Joyber

本文链接：https://blog.qqvbc.com/default/1580.html

转载时须注明出处及本声明