consoletvs/charts 已归档且不兼容 laravel 9+/php 8.1+，应改用 @json() + chart.js 方案；需用 pluck() 保证键值映射、@json() 安全输出 js 数据，并注意时区对齐与空月份处理。
ConsoleTVs/Charts 已停止维护，Laravel 9+ 项目中直接安装会因依赖冲突失败，不建议新项目采用。
ConsoleTVs/Charts 安装失败报错 composer require consoletvs/charts:7.* 怎么办
这个包在 2022 年底已归档，PHP 8.1+ 和 Laravel 9/10 的 illuminate/support 版本不兼容。常见错误是 Root composer.json requires consoletvs/charts ^7.4 -> satisfiable by consoletvs/charts[7.4.0] 后面跟着一堆 has conflicting dependencies。
- 别硬加
--ignore-platform-reqs—— 表面装上，运行时会抛Class "ConsoleTVs\Charts\Classes\Chart" not found - 检查
composer show consoletvs/charts，最新稳定版确实是7.4.0，但它只支持 Laravel 6–8、PHP 7.3–8.0 - 替代方案不是“降级 Laravel”，而是换轻量可控的集成方式：用
@json()+ 原生 Chart.js
用 Eloquent 聚合数据喂给 Chart.js，pluck('count', 'month') 为什么比 toArray() 更安全
因为 pluck('count', 'month') 明确指定键（month）为 key、值（count）为 value，返回的是 PHP 关联数组，@json() 输出后前端拿到的是标准 JSON object，比如 {"Jan": 12, "Feb": 19}；而 toArray() 返回的是索引数组，即使原始 Collection 有 key，也会被丢掉。
- 图表库（如 Chart.js）需要 labels 和 data 分离，你得自己拆：
labels: @json($data->keys())、data: @json($data->values()) - 如果误用
$data->values()->toArray()，得到的是[12, 19]，但月份信息（Jan/Feb）就丢了，图表横轴全变成 0, 1 - 时间分组记得对齐时区：
selectRaw("DATE_FORMAT(CONVERT_TZ(created_at, '+00:00', '+08:00'), '%Y-%m') as month")，否则 UTC 存储的数据按本地月统计会偏移
Laravel 控制器传 Chart.js 数据，const data = {{ $chartData }}; 报 Unexpected token
这是 Blade 模板里最常踩的坑：PHP 数组直接插进 JS 变量，没经过 JSON 转义，引号、换行、null 都会崩语法。
- 必须用
@json($chartData)—— 它自动调用json_encode(..., JSON_UNESCAPED_UNICODE | JSON_HEX_TAG)，输出安全字符串 - 别写
{{ json_encode($chartData) }}，它不处理 HTML 实体，&可能变成&，JS 解析失败 - 确保
$chartData是数组或 Collection，不是 Eloquent Model 实例（Model 会带大量不可序列化属性，@json()会静默截断或报错）
真正麻烦的不是怎么画图，而是聚合逻辑和数据结构之间的映射——Eloquent 的 groupBy 是否生效、字段名是否匹配前端 key、空月份要不要补零，这些细节一旦漏掉，图表就只是个空画布。
