Go go-echarts 全局配置与系列配置有什么区别

在 go-echarts 中，可以把配置先按“影响范围”分成两层：SetGlobalOptions 接收的全局配置属于整张图，AddSeries 的可选参数属于当前新增的数据系列。标题、图例、坐标轴、网格等共享规则放在前者；平滑曲线、线型、标签、区域样式、柱形宽度等只针对某一条系列的设置放在后者。

判断方法很简单：如果改动后整张图都应该变化，就先看 GlobalOpts；如果只有“销售额”或“访问量”这一条数据需要变化，就把 SeriesOpts 跟在对应的 AddSeries 后面。两者不是同一份配置的不同写法，而是图表对象与系列对象的两个作用域。

先看两种配置分别管什么

官方 charts 包把 GlobalOpts 定义为图表的全局选项函数，把 SeriesOpts 定义为单个系列的选项函数。图表类型通常提供 SetGlobalOptions，而 AddSeries 接收系列名、数据和可选的系列配置。因此，配置入口本身已经表达了层级。

“全局”不是全局变量的意思，也不是所有图表实例共享一个配置对象。它更准确的含义是“当前 chart 实例的共享配置”。同时创建两张图时，分别调用各自的 SetGlobalOptions，不会自动把标题或坐标轴复制到另一张图。

最小写法：整图规则放在 SetGlobalOptions

下面的片段只保留作用域最关键的部分：标题通过全局配置设置，随后再添加两条数据系列。它没有把示例扩展成完整页面，便于先看清调用关系。

chart := charts.NewLine()

// 全局配置作用于当前 chart，适合放整张图共享的标题等规则。
chart.SetGlobalOptions(
    charts.WithTitleOpts(opts.Title{Title: "访问量趋势"}),
)

// 每次 AddSeries 增加一条数据系列；系列样式跟在对应调用后面。
chart.AddSeries("自然流量", naturalData)
chart.AddSeries("付费流量", paidData)

这里的重点不是标题函数的数量，而是它接收在 SetGlobalOptions 中。要修改坐标轴、图例或网格时，仍然沿着这个入口查找对应的 WithXAxisOpts、WithLegendOpts 或 WithGridOpts。不同版本可能新增选项，具体函数名应以当前版本的 API 文档为准。

单条系列的样式放在 AddSeries 后面

系列配置的特点是“跟着数据走”。例如，同一张折线图中，访问量可以使用平滑曲线，订单量保留折线形状；两条系列共享标题和坐标轴，但不必共享线条表现。

chart := charts.NewLine()

// 标题是整张图的共享信息，不随某条数据系列改变。
chart.SetGlobalOptions(
    charts.WithTitleOpts(opts.Title{Title: "两类流量对比"}),
)

// 平滑只作用于“自然流量”这一条系列。
chart.AddSeries(
    "自然流量",
    naturalData,
    charts.WithLineChartOpts(opts.LineChart{Smooth: true}),
)

// 另一条系列可以单独使用线宽等表现，不会改变自然流量的样式。
chart.AddSeries(
    "付费流量",
    paidData,
    charts.WithLineStyleOpts(opts.LineStyle{Width: 2}),
)

如果需求是“所有系列都使用同一种默认线宽”，就不要在每个 AddSeries 中重复写一遍；应先确认 go-echarts 当前版本是否提供对应的公共主题或全局颜色能力。系列层适合表达差异，不能代替不存在的全局 API。

多系列组合时，先固定共享层，再处理差异

多系列图最容易出现的误解，是把“当前系列的样式”和“整张图的展示规则”混成一组。可以按下面的顺序拆解：

1. 先定共享规则：确定标题、横轴含义、纵轴单位、图例和网格，让所有系列拥有同一阅读坐标。
2. 再定系列差异：为需要强调的系列设置颜色、平滑、标签、线型或柱形宽度。
3. 最后检查数据语义：如果两条系列单位不同，不要仅靠系列颜色解决问题，应该考虑第二坐标轴或重新组织图表。

这也是配置边界的实际价值：全局层负责“读者如何理解这张图”，系列层负责“读者如何区分其中一条数据”。如果把一条系列的突出样式写成全局规则，图表增加第三条系列后，往往会出现所有数据都被同样强调的问题。

几个容易写错的地方

把 chart 级配置误当成进程级配置

GlobalOpts 是函数类型，作用对象是传入的图表配置，不等于包级单例。需要不同标题或坐标轴时，给不同 chart 实例分别设置即可。

把系列配置提前单独保存成“全局模板”

SeriesOpts 的签名面向单个系列。即使把它保存成变量，也要在对应的 AddSeries 中使用；不要因为变量名字叫“默认配置”就推断它会自动作用于所有系列。

看到同名选项就猜覆盖优先级

全局和系列并不是所有属性都存在同名覆盖关系。遇到颜色、标签或坐标轴这类边界，先看当前 go-echarts 版本的 charts 与 opts 文档，再决定放置位置。官方文档列出了 SetGlobalOptions、AddSeries 以及各类 With... 函数的签名，适合作为查 API 的入口。

按修改目标选择配置层级

可以用下面的速查表结束一次配置设计：

一句话总结：SetGlobalOptions 负责图表的共享语境，AddSeries 的 SeriesOpts 负责单条数据的局部表达。先按作用范围归类，再按当前版本 API 选择具体的 With... 函数，代码会比“所有选项都堆在一个地方”更容易维护。

相关问题

一个 chart 可以添加多条系列吗？

可以。对同一个 chart 多次调用 AddSeries，每次传入不同的系列名和数据；共享配置仍由 chart 层管理，局部样式随每次调用传入。

系列配置能不能复用？

可以把同一组 SeriesOpts 函数保存在变量中并传给多个系列，但复用前要确认这些样式确实适合所有系列。需要差异化时，拆成多个小配置更直观。

为什么改了全局配置，某条系列看起来没变化？

可能是该属性并不属于全局层，或者当前系列配置覆盖了同一视觉效果。先确认函数签名，再分别撤掉系列参数和全局参数做最小化排查。