Go go-echarts 怎样构造柱状图的数据系列

go-echarts构造普通分类柱状图时，用SetXAxis提供有序分类，每个指标整理成一份[]opts.BarData，再通过AddSeries加入图表。最关键的约定是：同一位置的数据项对应同一个分类。系列名称描述指标，不能代替分类轴标签。

官方包地址：https://pkg.go.dev/github.com/go-echarts/go-echarts/v2/charts。以下示例固定依赖v2.7.3，使用NewBar、SetXAxis和AddSeries组织两组数据，不涉及Dataset或自定义维度映射。

先把每个系列对齐到同一组分类

以三个仓库的入库、出库件数为例：分类轴依次是仓库甲、仓库乙、仓库丙，入库系列依次是24、17、31，出库系列依次是19、15、26。这里的“按位置对齐”是数据模型约定，不是渲染后再猜测标签的技巧。

categories保存统一顺序；inbound与outbound分别保存入库件数和出库件数。分类位置i决定要读取哪一个仓库，两份数值也读取位置i。这种方式适合少量、清晰、共享分类轴的业务对比。

为什么数据整理要放在图表配置之前

假设数据库分别返回两份聚合结果，一份按仓库名称排序，另一份按数量排序。如果直接把数值追加到两个系列，虽然长度相同，柱子却可能对应不同仓库。图表只能展示收到的数据，不能推断两次查询的业务关联。

更稳妥的组织方式是先确定完整的分类顺序，再按照这个顺序读取每个指标。使用map汇总时，也应按统一分类列表取值，避免把map遍历顺序当作展示顺序。缺失记录是零、未知还是应报错，需要由业务明确决定。

用BarData构造两组对比数据

新目录先创建Go模块，已有模块跳过初始化。把下面完整代码保存为main.go后运行，即可尝试生成HTML文件。示例中的仓库与数值均为演示数据，不是实际业务记录。

# 只在新的空目录中初始化模块
go mod init example.com/warehouse-bar
# 固定本文采用的依赖版本
go get github.com/go-echarts/go-echarts/v2@v2.7.3

package main

import (
    "fmt"
    "log"
    "os"

    "github.com/go-echarts/go-echarts/v2/charts"
    "github.com/go-echarts/go-echarts/v2/opts"
)

// makeBars 保留输入顺序，并为每个分类构造一个数值项。
func makeBars(values []int) []opts.BarData {
    data := make([]opts.BarData, len(values))
    for i, value := range values {
        data[i] = opts.BarData{Value: value}
    }
    return data
}

func run() error {
    // 每个位置代表同一个仓库；两组数值采用相同计量单位。
    categories := []string{"仓库甲", "仓库乙", "仓库丙"}
    inbound := []int{24, 17, 31}
    outbound := []int{19, 15, 26}
    if len(categories) == 0 ||
        len(inbound) != len(categories) ||
        len(outbound) != len(categories) {
        return fmt.Errorf("分类不能为空，各系列长度必须与分类一致")
    }

    // 一个AddSeries表示一个业务指标，而不是一个分类。
    bar := charts.NewBar()
    bar.SetGlobalOptions(charts.WithTitleOpts(opts.Title{
        Title: "仓库收发数量",
    }))
    bar.SetXAxis(categories).
        AddSeries("入库件数", makeBars(inbound)).
        AddSeries("出库件数", makeBars(outbound))

    // 生成HTML文件；浏览器显示还依赖ECharts脚本资源。
    file, err := os.Create("warehouse-bar.html")
    if err != nil {
        return fmt.Errorf("创建HTML失败: %w", err)
    }
    renderErr := bar.Render(file)
    closeErr := file.Close()
    if renderErr != nil {
        return fmt.Errorf("生成图表HTML失败: %w", renderErr)
    }
    if closeErr != nil {
        return fmt.Errorf("关闭HTML文件失败: %w", closeErr)
    }
    return nil
}

func main() {
    if err := run(); err != nil {
        log.Fatal(err)
    }
}

opts.BarData中的Value承载单项数值，makeBars只做类型适配，保留输入顺序。SetXAxis传入categories，两个AddSeries分别追加“入库件数”和“出库件数”。图表对象charts.Bar承载这些配置；Render将配置组织进输出，而不是在Go进程中直接生成PNG位图。

# 在main.go所在模块目录生成示例HTML
go run .

预期得到warehouse-bar.html。用浏览器打开时，还需要页面依赖的ECharts脚本资源能够加载；文件成功生成不代表浏览器端资源已经成功加载。本文没有执行示例，也没有截取页面，配图仅解释数据结构。

哪些写法会造成分类与数值错位

第一个反例是为每个仓库创建一个只含单值的AddSeries，这会把仓库变成指标系列，偏离“同一分类比较入库和出库”的目标。第二个反例是给BarData.Name填仓库名，却让分类轴保留另一种顺序，期待库自动按名称连接。本文采用显式分类轴和标量值，不依赖这种隐式匹配。

第三个反例是两份数值分别排序。若需要按入库量排列，应先排序完整的仓库业务记录，再一起构造分类、入库和出库切片。仅检查长度无法发现这种语义错位。

这种组织方式带来的取舍

把数据整理与图表配置分开后，图表函数更容易复用，业务层也能独立判断缺失值和单位。但这种方式要求调用方维护一个统一分类顺序；数据维度很多时，手动维护平行切片会增加出错机会，可考虑先用业务结构体保存记录，再一次性投影出所需切片。

本例按普通分组柱状图组织系列，没有配置堆叠。若要表达合计组成，堆叠是另一项展示决策，不应仅因系列数量增加就自动开启。另外，入库“件数”与出库“金额”不是相同单位，不能只更改系列名称就放在同一数值尺度上比较。

添加新系列前确认什么

只有一组数值怎么办？

保留分类轴，只调用一次AddSeries即可，不必人为增加空系列。

缺失分类能直接补零吗？

只有业务含义确实是“数量为零”时才这样做。未知值不能因为画图方便就当成零；先处理数据定义，再选择展示方式。

新增第三个指标需要改分类轴吗？

若它覆盖同一批分类，只需按相同顺序构造第三份BarData并追加系列。若出现新分类，应统一扩展分类列表，同时补齐或重新定义已有系列的对应项。

接口依据：charts包文档；结构语义参考Bar实现和BarData定义。上游主分支会变化，项目应固定自身依赖版本。