ECharts 安装

ECharts 安装指南

Apache ECharts 当前最新版本是 6.0.0(发布于 2025 年 7 月左右)。ECharts 支持多种安装和引入方式,适用于不同开发场景。以下是常见方法:

1. 通过 CDN 引入(推荐初学者和快速原型)

最简单的方式,无需下载或安装,直接在 HTML 中引用 CDN 链接。

  • 推荐 CDN
  • jsDelivr(官方推荐,速度快,支持版本指定):
    html ¨K11K
    或不指定版本,使用最新版:
    html ¨K12K
  • 其他常用 CDN:
    • unpkg:https://unpkg.com/echarts@6.0.0/dist/echarts.min.js
    • cdnjs:https://cdnjs.cloudflare.com/ajax/libs/echarts/6.0.0/echarts.min.js

完整示例(直接复制到 HTML 文件运行):

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="utf-8">
    <title>ECharts 安装示例</title>
    <!-- 通过 CDN 引入 ECharts -->
    <script src="https://cdn.jsdelivr.net/npm/echarts@6.0.0/dist/echarts.min.js"></script>
</head>
<body>
    <div id="main" style="width: 800px; height: 500px;"></div>
    <script>
        var myChart = echarts.init(document.getElementById('main'));
        myChart.setOption({
            title: { text: '简单柱状图' },
            tooltip: {},
            xAxis: { data: ['A', 'B', 'C', 'D'] },
            yAxis: {},
            series: [{ type: 'bar', data: [10, 20, 30, 40] }]
        });
    </script>
</body>
</html>

2. 通过 npm 安装(推荐现代前端项目,如 Vue、React、Angular)

适用于使用包管理器的项目。

npm install echarts@6.0.0
# 或安装最新版
npm install echarts

在代码中引入:

import * as echarts from 'echarts';
// 或按需引入(如只用柱状图和折线图,减小体积)
import echarts from 'echarts/core';
import { BarChart, LineChart } from 'echarts/charts';
import { GridComponent, TooltipComponent } from 'echarts/components';
import { CanvasRenderer } from 'echarts/renderers';

echarts.use([BarChart, LineChart, GridComponent, TooltipComponent, CanvasRenderer]);

// 然后初始化
var myChart = echarts.init(document.getElementById('main'));

3. 下载文件本地引入

  • 从官网下载:https://echarts.apache.org/zh/download.html
  • 或从 GitHub Releases 下载:https://github.com/apache/echarts/releases (选择 apache-echarts-6.0.0-dist.zip)
  • 解压后使用 dist/echarts.min.js,在 HTML 中:
  <script src="path/to/echarts.min.js"></script>

4. 从源码构建(高级用户)

  • 克隆 GitHub 仓库:git clone https://github.com/apache/echarts.git
  • 安装依赖:npm install
  • 构建:npm run build
  • 输出在 dist 目录。

注意事项

  • ECharts 6.0 有一些 breaking changes(如默认主题变化、标签样式继承),升级前请查看迁移指南:https://echarts.apache.org/handbook/zh/basics/release-note/v6-migration/
  • 对于大项目,推荐按需引入组件以减小 bundle 体积。
  • ECharts 支持 AMD、CommonJS、ESM 等模块规范。

如果你的项目是特定框架(如 Vue3、React),或需要按需加载示例,告诉我,我可以提供更针对性的代码!

文章已创建 3420

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注

相关文章

开始在上面输入您的搜索词,然后按回车进行搜索。按ESC取消。

返回顶部