饼图：标题与数据标签

简介 / Introduction

饼图（Pie Chart）用于展示各部分占整体的比例，是数据可视化的基础图形之一。本文对比 PlantUML 与 Mermaid 绘制带标题与数据标签饼图的语法差异。

PlantUML 版

@startuml
title 软件项目工期分布

skinparam titleFontSize 14
skinparam legendFontSize 12

skinparam pieTitleFontSize 16
skinparam pieTitleFontColor blue

skinparam pieVerticalLabelPosition 2
skinparam pieElementFontSize 11
skinparam pieElementFontColor black
skinparam pieBorderThickness 1

legend right
  <color:blue>**工期分布**</color>
  开发 45%
  测试 25%
  部署 15%
  文档 15%
endlegend

' 数据标签通过 legend 块内嵌文字实现
@enduml

PlantUML 使用 title、legend 块与 skinparam 组合控制标题与图例。数据标签嵌入 legend 内，与图形分离。

Mermaid 版

pie title 软件项目工期分布
    "开发" : 45
    "测试" : 25
    "部署" : 15
    "文档" : 15

Mermaid 语法极简：pie + title + 键值对列表。标题直接写在 pie 关键字后，无需额外 skinparam。

对比 / Side-by-side

特性	PlantUML	Mermaid
标题语法	`title xxx`	`pie title xxx`
数据标签	legend 内嵌文字	键值对 `: number`
颜色控制	`skinparam pieElementFontColor`	关键字加引号
图例外置	`legend right / left`	需通过 CSS 覆盖
语法复杂度	高（多 skinparam）	低（一行标题 + 数据）

小结 / Wrap-up

PlantUML 饼图灵活性高，适合需要精细控制字体、颜色和图例位置的场景；Mermaid 饼图胜在语法简洁，一行标题加数据键值对即可出图。实际选用可根据团队审美偏好与图表复杂度需求决定。