CircularBuffer 的 Symbol.iterator 默认无限循环读取有效元素，通过模运算实现环形访问；支持 times 参数控制遍历轮数，空缓冲区立即结束迭代，且迭代器为只读视图。
用 Iterator 实现固定大小环形缓冲区的循环读取，核心是让 Symbol.iterator 方法返回一个迭代器对象，该对象在遍历时自动按环形逻辑（索引模容量）访问内部数组，且支持无限/有限次遍历、不破坏原始数据结构。
环形缓冲区基础结构设计
先定义一个带容量限制、支持 push/pop 的环形缓冲区类，内部用数组 + 读写指针（或仅靠模运算）管理。为支持迭代，关键不是暴露指针，而是把“从头开始循环读取”这一行为封装进迭代器：
- 用
Array存储数据，长度固定（如this.buffer = new Array(capacity)） - 维护
this.size表示当前有效元素个数（非容量），避免混淆“满”与“空” - 不依赖 head/tail 指针来驱动迭代器——迭代应无视插入历史，只按逻辑顺序：第 0 次 yield 第 0 个有效元素，第 1 次 yield 第 1 个……第 n 次 yield 第
n % size个
实现可循环的 Symbol.iterator
让缓冲区自身可被 for...of 遍历，并默认无限循环（也可加选项控制次数）。重点在于迭代器对象的 next() 方法持续返回下一个元素，利用模运算实现“绕回”：
class CircularBuffer {
constructor(capacity) {
this.capacity = capacity;
this.buffer = [];
this.size = 0;
}
<p>push(item) {
if (this.size < this.capacity) {
this.buffer.push(item);
this.size++;
} else {
this.buffer.shift(); // 或更高效地用索引替换，此处简化
this.buffer.push(item);
}
}</p><p>*[Symbol.iterator]() {
if (this.size === 0) return;
let index = 0;
while (true) {
yield this.buffer[index % this.size];
index++;
}
}
}这样写后，for (const x of new CircularBuffer(3).push(1).push(2).push(3)) { console.log(x); } 会无限输出 1,2,3,1,2,3…
立即学习“Java免费学习笔记（深入）”；
可控迭代：支持有限次循环或单轮遍历
实际中常需“遍历 N 轮”或“只读一遍所有现存元素”。可在迭代器工厂方法中接收参数，返回不同行为的迭代器：
- 传入
times = 1→ 只 yield 当前全部size个元素（单轮） - 传入
times = Infinity（默认）→ 无限循环 - 传入数字
n→ 总共 yieldn * size次
示例：
*[Symbol.iterator](options = {}) {
const { times = Infinity } = options;
const total = Number.isFinite(times) ? times * this.size : Infinity;
let count = 0;
let index = 0;
while (count < total) {
yield this.buffer[index % this.size];
index++;
count++;
}
}调用时：for (const x of buf[Symbol.iterator]({ times: 2 })) { ... } —— 精确读两轮。
注意点与优化建议
直接用 index % size 简洁可靠，但需确保 size > 0；若缓冲区为空，迭代器应立刻结束（return 或不进入 while）。
- 避免在迭代中修改缓冲区内容（如 push/pop），否则可能造成不可预期的索引偏移——Iterator 应视为只读视图
- 如需高性能，内部改用定长数组 + head/tail 索引，迭代时用
this.buffer[(this.head + i) % this.capacity]计算实际位置，而非依赖shift/push导致的数组移动 - 想支持
Array.from(buf)或展开语法[...buf]？那得限制为单轮遍历（否则会卡死），此时可额外提供values()方法返回单轮迭代器
