<p>VSCode需安装@types/echarts并配置jsconfig.json/tsconfig.json才能实现ECharts智能提示；必须用import * as echarts from 'echarts'，且配置中需含"types": ["echarts"]。</p>
VSCode 本身不直接支持 ECharts 的智能提示，必须靠 TypeScript 类型定义 + 项目级配置 + 正确引用方式才能触发补全。装再多“ECharts 插件”都没用，真正起作用的是 @types/echarts 和你项目里是否被识别为 TypeScript/JavaScript 项目。
为什么 import echarts 后 . 不出方法？
常见错误现象：写完 import * as echarts from 'echarts'，光标停在 echarts. 后没任何提示，Ctrl+Space 也只显示几个基础属性。
- 根本原因不是插件没装，而是 VS Code 没加载到 ECharts 的类型定义——它只知道这是个对象，不知道它有哪些方法和配置项
- 即使你已安装
echarts包，若没装@types/echarts，TS/JS 语言服务就无法推导echarts.init、echarts.registerTheme等函数签名 - 如果项目没有
jsconfig.json或tsconfig.json，VS Code 默认以“无类型 JS”模式打开文件，连import语句都可能被忽略，更别说补全了
必须装的包和配置文件
补全生效的前提是让语言服务“认出”你在用 ECharts，并且能读到它的类型信息。
ECharts Master
下载
ECharts 图表大师。根据用户数据和业务上下文，自动设计并生成专业的 ECharts 可视化图表。使用场景：(1) 用户提供表格/JSON/CSV 数据需要可视化，(2) 用户说"帮我做个图"、"画个图表"，(3) 需要将查询结果可视化展示。
- 运行
npm install --save-dev @types/echarts（或yarn add -D @types/echarts）。注意：不是@types/echarts-gl或其他子包，主包才覆盖核心 API - 确保项目根目录有
jsconfig.json（JS 项目）或tsconfig.json（TS 项目）。最简jsconfig.json内容如下：
{
"compilerOptions": {
"module": "nodenext",
"target": "es2020",
"allowJs": true,
"checkJs": true,
"moduleResolution": "nodenext",
"types": ["echarts"]
},
"include": ["**/*.js", "**/*.ts"],
"exclude": ["node_modules"]
}-
"types": ["echarts"]这一行不能少——它显式告诉 TS 服务去加载@types/echarts，否则即使包已安装，也可能被跳过 - 删掉
jsconfig.json后补全立刻消失？说明它确实在起作用
import 方式影响补全质量
ECharts 的不同引入方式，导致 VS Code 解析出的类型信息完整度不同。
- 推荐用 ES Module 方式：
import * as echarts from 'echarts'。这种方式能完整映射全局命名空间，echarts.补全最全（含init、getInstanceByDom、registerTheme等） - 避免
import echarts from 'echarts'（默认导出），ECharts 官方包没有默认导出，这样写会导致类型丢失，补全只剩any - 如果用 script 标签全局引入（
<script src="echarts.min.js"></script>），需额外加// @ts-ignore或声明全局变量，补全基本不可靠 - 使用按需引入（如
import { init } from 'echarts'）时，只有init可补全，其他方法不会出现——这不是 bug，是类型系统按需加载的结果
容易被忽略的细节：路径别名和 monorepo 场景
如果你的项目用了 @/utils/chart 这类别名，或处于 monorepo 多包结构中，补全很容易中断。
-
jsconfig.json中必须声明"compilerOptions.baseUrl"和"compilerOptions.paths"，否则import { init } from '@/echarts'这种写法会导致类型解析失败，补全空白 - monorepo 中每个 package 都要单独配
jsconfig.json，VS Code 不会跨 workspace 自动继承类型配置 - 确认
node_modules/@types/echarts目录真实存在，且不是被 pnpm/yarn 的硬链接机制“藏”到了 store 里而未被 TS 服务扫描到（可临时改用 npm 测试） - 重启 VS Code 后首次打开文件，留意右下角语言模式是否为
JavaScript（不是Plain Text），并检查状态栏是否有TS Server正在运行的提示
