上周有个做电商运营的朋友找我吐槽,说老板临时要一个销售数据大屏,明天就要。他打开百度搜”echarts下载”,跳出来的前几条全是某下载站、某CSDN积分帖,点进去要么是2018年的4.x版本,要么要先关注公众号再回复关键词领压缩包。折腾四十分钟,图表没画出来,桌面上多了三个”高速下载器”。
这事儿听着离谱,但每天都在发生。根源就一句话:ECharts是Apache旗下的开源项目,免费、无广告、随便商用,可它的官方下载入口藏得比一些资源站的广告还深。很多人压根不知道有官网这回事,自然就被各种二手渠道牵着走。
这篇文章就把”echarts 图表插件下载”这件事彻底讲透:去哪下、怎么选、插件从哪来、版本怎么避坑。看完你五分钟能搞定的事,别再用一下午。
认准一个官网,其他都是弯路
先把最重要的话说死:ECharts唯一的官方下载地址是 echarts.apache.org。这是Apache软件基金会的顶级项目,代码托管在apache/echarts仓库,任何人都可以免费下载,包括商用。
截至我写这篇文章的时候,官方最新版本是 6.1.0,2026年5月19日发布(官网下载页)。官网给了三条路:
- 源码包:从镜像站下
apache-echarts-6.1.0-src.zip,适合想看源码或者二次开发的人。官网还贴心地给了SHA-512校验和GPG签名验证步骤——正规军就是这么让人放心。 - GitHub:releases页面Assets里点Source code,解压后
dist目录下的echarts.js就是完整功能文件。 - npm:
npm install echarts,工程项目的标准姿势。
为什么反复强调官网?因为第三方资源站的问题是真金白银的坑:版本落后三四年、文件被重新压缩打包、有的还夹带私货。图表库这种东西,你引入的每一行代码都会跑在用户的浏览器里,来源不干净,等于把大门钥匙给了陌生人。免费的正版就在那,没必要冒这个险。
三条下载路线,按你的场景对号入座
光知道官网还不够,关键是选对方式。我按最常见的三种人给方案:
场景一:我就想快速出张图,不在前端工程里折腾。 用CDN,一行代码解决:
<script src="https://cdn.jsdelivr.net/npm/echarts@6.1.0/dist/echarts.min.js"></script>
jsDelivr、unpkg、cdnjs都免费可用,官方文档里都列了。注意版本号别照抄网上的@5.4.3,写清楚你要的版本,不然今天跑得好好的,CDN哪天给你换个最新版,图表可能就花了。
场景二:正经项目,用Vue/React这类框架。 别犹豫,npm:
npm install echarts
然后import * as echarts from 'echarts'。走构建工具的好处是按需引入、可锁版本、团队协作不打架。
场景三:只想要两三个图表类型,嫌1MB多的完整包太大。 官网有个宝藏功能叫在线定制(下载页的”选择需要的模块”),像点菜一样勾选你要的图表和组件,打包出一个瘦身版。只画折线柱状图的话,体积能砍掉一大半。
另外说句国内用户的实在话:jsDelivr在国内偶尔抽风,如果你的访客主要在国内,把文件下载下来放自己服务器上是最稳的,也就一个JS文件的事。想要现成的国内CDN,staticfile之类的镜像也能用,但版本更新会慢半拍,自己掂量。
“插件”两个字,才是ECharts真正的深坑
很多人搜”echarts插件下载”,其实想要的是水球图、词云、3D地图这类官网没有直接给的东西。这就得聊聊ECharts的插件生态了。
像水球图(echarts-liquidfill)这种经典扩展,标准装法是npm:npm install echarts-liquidfill,然后import 'echarts-liquidfill',几行代码就能出那种大屏里常见的波动水球。官方还有一个echarts-custom-series项目,里面是小提琴图、睡眠阶段图、分段环形图这类高级货。
这里有个2025年以来的大变化值得说:ECharts 6把自定义系列做成了npm化的标准机制。以前你想复用别人写的自定义图表,只能复制粘贴一大段renderItem代码;现在像注册主题一样一行引入就能用,官方一口气发布了6款新图表。如果你还在用5.x的老项目,这条升级理由就足够硬了——当然,升级前先去看官方升级指南,6.0的默认主题有变动,直接升图表配色可能会变。
至于主题(theme),官网有专门的主题下载页,几十套配色一键下载引入。想做那种深色科技风大屏,真不用自己调半天颜色。
版本这件事,比你想的容易翻车
最后说个老手也会栽的坑:版本。
别裸奔@latest。 写CDN地址或者package.json时不锁版本,等于把项目的命交给CDN服务商。今天6.1.0,明天6.2.0发布,你的图表样式可能悄悄变了,排查起来能掉头发。
老项目升级要看升级指南。 ECharts 5升6,绝大多数API是兼容的,但默认主题变了、部分老API被标记为不推荐。官方有完整的v6升级指南,升级前花十分钟扫一眼,能省十个小时调试。
下载完顺手验证一下。 官网每个源码包都附了.sha512校验文件,一条命令的事:
shasum -a 512 apache-echarts-6.1.0-src.zip
对得上,说明文件在传输路上没被篡改。别嫌麻烦,你把它当基础设施用,这点仪式感不算多。
结尾说两句
回到开头那个被”高速下载器”折磨的朋友,我后来就把官网链接甩给他,他从下载到出第一张折线图,全程没超过十分钟。 he真正浪费的那四十分钟,不是技术问题,是信息不对称——不知道免费的东西该去哪拿。
其实做技术选型、找工具,跟买菜一个道理:先去正规市场看标价,再决定要不要去路边摊讨价还价。 echarts这玩意儿,官网就是菜市场本市场,新鲜、免费、还不缺斤短两。
下次再有人问你”echarts图表插件在哪下载”,直接把这篇文章甩过去。也欢迎在评论区聊聊,你当年为了下个echarts,交过多少”学费”?
参考资料:Apache ECharts 官网下载页、获取ECharts - 官方使用手册、ECharts 6 新特性、v5升级v6指南、echarts-liquidfill 插件文档
