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",}     → Trailing comma, unquoted key
✅ {"field": "x"}    → Proper JSON

规则 3：字段名必须与数据一致

❌ "field": "Category"  when data has "category"
✅ "field": "category"  → Case-sensitive match

规则 4：类型必须有效

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

---

常见问题

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

---

输出格式

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

或使用完整的 Vega：

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

---

相关文件

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

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