Go go-chart 隐藏坐标轴与隐藏序列有什么区别

在 go-chart 里，隐藏坐标轴和隐藏序列不是同一件事：HideXAxis()、HideYAxis() 改的是坐标参照层，chart.Hidden() 改的是某个 Series 的绘制状态。前者可以让曲线继续画出来但不显示刻度或轴线，后者则让这条数据不再参与可见绘制，其他序列和坐标体系仍可保留。

官方地址：https://pkg.go.dev/github.com/wcharczuk/go-chart/v2

先把坐标轴和序列看成两层对象

我第一次遇到这个区别，是在同一个图表里同时放趋势线和参考线：设计要求去掉边缘刻度，但参考线仍要参与画面；后来又需要按开关暂时不显示其中一条业务曲线。把两个需求都写成“隐藏”，结果就很容易改错对象。

go-chart 的 Chart 同时持有 XAxis、主 YAxis、可选的 YAxisSecondary 和 Series。因此可以先用下面这张表建立边界：

隐藏坐标轴时保留数据绘制

go-chart 提供了 HideXAxis() 和 HideYAxis() 这样的便捷构造函数。它们表达的是“这一条轴不作为可见参照”，不是把 Chart.Series 清空。下面的写法适合火花线、卡片内趋势图等不需要刻度的场景：

graph := chart.Chart{
    // 隐藏横轴，趋势线仍由 Series 绘制。
    XAxis: chart.HideXAxis(),
    // 隐藏纵轴，避免卡片图占用边距。
    YAxis: chart.HideYAxis(),
    Series: []chart.Series{
        chart.TimeSeries{
            Name: "请求量",
            // 这里只控制数据线，不影响上面的轴配置。
            Style: chart.Style{StrokeWidth: 2},
            XValues: times,
            YValues: values,
        },
    },
}

这种配置的代价是读者失去刻度和轴名，不能再把图当作精确读数图。若仍需要网格线或数值标签，应保留轴，只调整 Style、TickStyle 或格式化器，而不是直接隐藏整条轴。

隐藏序列时保留坐标体系

如果需求是“图例里的预测线先不显示”或“暂时关闭一项指标”，应该改这一条 Series 的样式。chart.Hidden() 返回一个 Hidden 为 true 的样式；它和 chart.Shown() 是成对的预置值。

graph := chart.Chart{
    // 坐标轴继续提供读数参照。
    XAxis: chart.XAxis{},
    YAxis: chart.YAxis{},
    Series: []chart.Series{
        chart.TimeSeries{
            Name: "实际值",
            Style: chart.Shown(),
            XValues: times,
            YValues: actual,
        },
        chart.TimeSeries{
            Name: "预测值",
            // 只隐藏预测序列，实际值和坐标尺度仍保留。
            Style: chart.Hidden(),
            XValues: times,
            YValues: forecast,
        },
    },
}

这里不要把隐藏序列误解成删除序列：它仍然是 Chart 的一个成员，后续可以把样式切回 chart.Shown()。如果你还在外部维护图例或开关状态，要同步更新自己的 UI 状态，不能只依赖图表内部的隐藏标记。

用需求和副作用选择配置

实际排查时，我会先问一句：读者还需不需要知道数值尺度？需要，就优先保留轴；只是想减少画面干扰，再处理序列。两者也可以同时使用，但要明确这会得到一张“只看形状”的图，而不是可精确比较的图。

相关问题

隐藏序列会不会自动改变 Y 轴范围？

不要把它当成重新计算范围的开关。先按当前版本的绘制行为确认范围来源；如果业务要求隐藏前后尺度稳定，应显式设置 Range 或在数据层决定参与范围计算的集合。

只想隐藏刻度文字，能直接用 HideYAxis 吗？

不建议。HideYAxis 表达的是隐藏纵轴这一整层；只隐藏文字时，应保留轴并调整名称、TickStyle 或 ValueFormatter，避免连网格和参照一起消失。

为什么曲线还在，但我看不到坐标？

优先检查 Chart 的 XAxis/YAxis 是否使用了 HideXAxis 或 HideYAxis，再检查是否只是把 TickStyle 设成了隐藏。曲线仍在通常说明序列本身没有被隐藏。