根本原因是缺少@types/echarts类型定义或未正确加载：需npm install @types/echarts --save-dev，并确保项目有tsconfig.json、文件语言模式正确，cdn引入时需加/// ，按需引入须注册全部用到的图表与渲染器组件。
VSCode里写 ECharts 没有配置项提示，不是插件没装全，而是缺了类型定义和正确加载路径这两块。
为什么 option 里写 xAxis 或 series 没有自动补全
根本原因是 TypeScript 类型系统没识别到 ECharts 的配置结构。VSCode 默认只对原生 JS 提供基础提示，echarts.init() 返回的实例类型、setOption() 接收的参数结构，都需要 @types/echarts 提供接口定义。
- 没装
@types/echarts：运行npm install @types/echarts --save-dev - 装了但没生效：检查当前文件是否在 TS 项目下（有
tsconfig.json），或是否被识别为.js文件（右下角状态栏确认语言模式是 JavaScript 或 TypeScript） - 用的是 CDN 引入（
<script src="...echarts.min.js"></script>）：这种全局变量方式，TS 不会自动关联类型，必须手动添加三斜线引用：/// <reference types="echarts"></reference>放在 JS 文件顶部
按需引入时 echarts.use([...]) 后仍无提示
按需引入本身不破坏类型提示，但容易漏掉关键步骤：注册组件后，setOption() 的类型推导依赖你实际注册的模块。比如只注册了 BarChart 和 GridComponent，那 series.type: 'line' 就不会被校验，也不会提示 line 相关配置。
ECharts Master
下载
ECharts 图表大师。根据用户数据和业务上下文，自动设计并生成专业的 ECharts 可视化图表。使用场景：(1) 用户提供表格/JSON/CSV 数据需要可视化，(2) 用户说"帮我做个图"、"画个图表"，(3) 需要将查询结果可视化展示。
- 确保所有用到的图表类型都已注册：
LineChart、PieChart等要显式 import 并传入echarts.use() - 渲染器（
CanvasRenderer或SVGRenderer）必须注册，否则echarts.init()返回类型不完整 - 如果用
import * as echarts from 'echarts/core'，不要同时又import echarts from 'echarts'，冲突会导致类型覆盖失效
配置项写错类型却没报错？检查这几个地方
常见“写了但不生效”其实是类型没约束住，比如把 yAxis.type 写成 'category'（应为 'value' 或 'category'，但后者在 y 轴上多数无效），TS 却没报错——说明类型定义没走通。
- 打开一个 .ts 或 .js 文件，输入
echarts.，看是否有init、registerTheme等方法提示；没有就说明类型未加载 - 在
setOption()参数里写{ xAxis: { type: 'time' } }，鼠标悬停看type的提示是否显示可选值；若只显示string，说明接口没解析到 - VSCode 设置中搜索 “suggest”，确认
javascript.suggest.autoImports和typescript.suggest.autoImports是启用状态
最易忽略的一点：类型提示依赖于项目根目录下的 node_modules/@types/echarts 存在且版本与 ECharts 主包兼容。2026 年最新版 echarts@5.4.3 对应的 @types/echarts 版本至少要是 5.4.x，低版本可能缺失新配置项如 dataset.transform 或 series.encode 的定义。
