# Chart.js

> 分类：`libs/charts/` · 档位：**评估** · 更新时间：2026-11-17

## 1. 基本信息

| 项 | 内容 |
|---|---|
| 当前版本 | 4.x |
| License | MIT |
| 维护方 | Chart.js 社区（Open Collective 支持） |
| 仓库 / 文档 | https://github.com/chartjs/Chart.js · https://www.chartjs.org |
| 最近 release | 见官方 releases |

## 2. 一句话定位

基于 Canvas 的通用图表库：折线、柱状、饼图、雷达、散点等开箱即用，配置式 API，默认样式克制。
它不负责复杂交互编排或大数据渲染，那类场景要换 ECharts / uPlot / D3。

## 3. 体积

| 引入方式 | min | gzip |
|---|---|---|
| 全量（UMD） | 约 200 KB | 约 46 KB（第三方对比口径，待实测） |
| 按需注册（仅 line + 必要组件） | 明显更小 | 待实测 |

v4 支持 tree-shaking：只 `register` 用到的 controller / element / scale。

## 4. 核心 API

```js
import { Chart, registerables } from 'chart.js';
Chart.register(...registerables);

new Chart(canvas, {
  type: 'line',
  data: { labels, datasets: [{ data }] },
  options: { responsive: true, maintainAspectRatio: false },
});

chart.update();
chart.destroy();
```

## 5. 适用 / 不适用

- **适用**：后台仪表盘、运营报表、原型验证，需要快速出图且样式可控。
- **不适用**：十万级数据点、复杂联动与地图类可视化（选 ECharts / uPlot / D3）。

## 6. 硬缺口与已知坑

- v4 起是 ESM-only 包（仍提供 UMD 构建），老构建链路需注意。
- 不注册对应 controller/scale 会直接报 "not a registered" 错误。
- 容器必须有确定高度，否则 `responsive` 下会塌陷或反复 resize。
- 大数据量动画开销明显，可关 `animation` 或降采样。
- 无障碍支持有限，需要自己补表格或 `aria-label`。

## 7. 受限环境可用性

| 环境 | 结论 | 说明 |
|---|---|---|
| 无构建（UMD `<script>`） | 可用 | 直接拿 UMD 构建 |
| ESM / 打包器 | 可用 | 推荐，可按需注册 |
| SSR | 需守卫 | Canvas 依赖浏览器 |
| 客户端重渲染 | 需处理生命周期 | 重建前 `destroy()` |

## 8. 稳定性评分

| 维度 | 评分 | 依据 |
|---|---|---|
| 维护活跃度 | 5 | 长期活跃，版本节奏稳定 |
| 版本与破坏性变更 | 4 | v4 迁移文档完整 |
| 采用度 | 5 | 使用面极广 |
| 体积与按需 | 4 | 全量偏大，树摇后可接受 |
| 生态兼容 | 5 | 纯 Canvas，无依赖 |
| License | 5 | MIT |

## 9. 替代品对比

| 库 | 优势 | 劣势 | 何时选它 |
|---|---|---|---|
| ECharts | 图表类型与交互最全 | 体积大 | 复杂仪表盘 |
| ApexCharts | 开箱样式好、交互丰富 | 体积大、定制受限 | 快速做漂亮图表 |
| uPlot | 约 20 KB，百万级数据流畅 | 图表类型少、样式要自己写 | 时序大数据 |
| D3 | 完全可控 | 学习成本高 | 定制可视化 |
