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 </p><p>*[Symbol.iterator]() {
if (this.size === 0) return;
let index = 0;
while (true) {
yield this.buffer[index % this.size];
index++;
}
}
}</p>
这样写后，for (const x of new CircularBuffer(3).push(1).push(2).push(3)) { console.log(x); } 会无限输出 1,2,3,1,2,3…
可控迭代：支持有限次循环或单轮遍历
实际中常需“遍历 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 <p>调用时：<code>for (const x of buf[Symbol.iterator]({ times: 2 })) { ... }</code> —— 精确读两轮。</p><h3>注意点与优化建议</h3><p>直接用 <code>index % size</code> 简洁可靠，但需确保 <code>size > 0</code>；若缓冲区为空，迭代器应立刻结束（<code>return</code> 或不进入 while）。</p>
- 避免在迭代中修改缓冲区内容（如 push/pop），否则可能造成不可预期的索引偏移——Iterator 应视为只读视图
- 如需高性能，内部改用定长数组 + head/tail 索引，迭代时用
this.buffer[(this.head + i) % this.capacity]计算实际位置，而非依赖shift/push导致的数组移动 - 想支持
Array.from(buf)或展开语法[...buf]？那得限制为单轮遍历（否则会卡死），此时可额外提供values()方法返回单轮迭代器
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
