vega

Vega / Vega-Lite 可视化工具

快速入门： 将数据结构化为对象数组 → 选择标记类型（bar/line/point/area/arc/rect）→ 将编码（x, y, color, size）映射到字段 → 设置数据类型（quantitative/nominal/ordinal/temporal）→ 包裹在 ```vega-lite 或 ```vega 代码块中。始终包含 $schema，使用有效的 JSON（双引号），字段名区分大小写。90% 的图表使用 Vega-Lite；仅雷达图、词云、力导向图使用 Vega。

---

关键语法规则

规则 1：始终包含 Schema

"$schema": "https://vega.github.io/schema/vega-lite/v5.json"

规则 2：仅有效 JSON

❌ {field: "x",}     → 尾随逗号，未加引号的键
✅ {"field": "x"}    → 正确的 JSON

规则 3：字段名必须与数据匹配

❌ "field": "Category"  当数据中有 "category"
✅ "field": "category"  → 大小写敏感匹配

规则 4：类型必须有效

✅ quantitative | nominal | ordinal | temporal
❌ numeric | string | date

---

常见陷阱

问题	解决方案
图表未渲染	检查 JSON 有效性，验证 $schema
数据未显示	字段名必须完全匹配
图表类型错误	将标记类型与数据结构匹配
颜色不可见	检查颜色比例对比度
双轴问题	添加 resolve: {scale: {y: "independent"}}

---

输出格式

```vega-lite
{...}
```

或用于完整 Vega：

```vega
{...}
```

---

相关文件

有关高级图表模式和复杂可视化，请参考以下参考资料：

• examples.md — 堆叠条形图、分组条形图、多系列折线图、面积图、热力图、雷达图（Vega）、词云（Vega）和交互式图表示例