Go 怎么用环形缓冲保存最近一组采样值

监控程序经常只需要最近 60 次温度、延迟或 CPU 采样，没必要让切片无限增长。Go 标准库的 container/ring 可以把固定数量的元素连成环：写指针走到末尾后回到开头，新的值覆盖最旧的值。

实现最近 N 个采样值的关键是约定一个“下一次写入位置”，再单独记录有效数量。ring.Ring 自己只负责环和移动，不会替你判断哪些槽位已经写过。

先把写入位置和有效数量分开

ring.Ring 是循环链表元素的引用，环没有固定的头尾；拿到任意节点都可以通过 Next 和 Prev 继续移动。这个特性适合固定窗口，但也带来一个容易忽略的边界：刚创建的环里每个 Value 都是 nil，它们不是有效采样。

因此采样器需要三个状态：容量 capacity、下一次写入的节点 write，以及已经写入的数量 count。count 最大只能到容量，写满后继续写只移动窗口，不再增加数量。

用 container/ring 写入最近采样值

下面的实现把“下一次要覆盖的节点”保存在 write 中。写入后让它指向下一个节点；当窗口写满时，write 恰好就是最旧值所在的位置，也是按时间顺序读取时的起点。

package main

import (
    "container/ring"
    "fmt"
)

type Samples struct {
    slots    *ring.Ring // 固定数量的采样槽位
    write    *ring.Ring // 下一次写入或覆盖的位置
    count    int        // 当前有效采样数，不超过容量
    capacity int        // 窗口大小
}

func NewSamples(capacity int) *Samples {
    if capacity 

这里没有把 ring.Do 直接当成导出方法，因为它会访问环里的全部元素；窗口未写满时，后面的节点仍然是 nil。示例用 count 限制读取范围，并在写满后从 write 开始，刚好得到最早到最新的顺序。

导出时要区分未写满和已覆盖

这段逻辑最容易错在“从哪里开始读”。未写满时，write 还没有回到起点，最早样本在 s.slots；写满以后，write 指向最旧样本，应该从它开始。这个判断也让返回的切片天然按采样时间升序排列。

如果采样值可能不是 float64，可以把 Value 放入自定义结构体，例如同时保存时间戳、来源和数值。读取时必须保持类型断言与写入类型一致；生产代码里若环节点来自外部调用，建议改成带类型检查的断言，避免错误数据触发 panic。

容量、并发和 API 选择怎么定

环形缓冲适合“只保留最近窗口”的场景，例如滑动平均、最近错误上下文和实时仪表盘。容量应该由采样频率与观察时长共同决定：每秒 2 次、保留 30 秒，容量至少是 60；如果还要看时间间隔，就把时间戳和数值放在同一个结构体里。

container/ring 本身没有并发保护。一个 goroutine 写、另一个 goroutine 读时，应在外层加互斥锁，或把 Add/Values 都放到单独的采样 goroutine 中，通过 channel 传递快照。若只需要追加后按下标读取，普通切片加取模下标更直观；只有在需要环节点移动、插接或双向遍历时，才值得直接使用 ring.Ring。

常见问题

为什么不能只用 ring.Len() 判断有多少数据？

Len 返回环的元素总数，与已经写入多少个采样无关。有效数量要由采样器自己维护。

写满以后最旧值在哪里？

如果每次写完都让 write 前进，那么写满后 write 指向的节点就是下一次将被覆盖的最旧值，也是按时间顺序导出的起点。

能不能在 Add 和 Values 之间直接共享 ring？

不建议。环的移动和 Value 写入都不是并发安全操作；共享时请加锁，或者传递复制后的切片快照。

把写指针、有效数量和导出起点约定清楚后，container/ring 就能稳定地承担最近 N 次采样的固定窗口，而不会因为历史数据持续增长拖慢后续处理。