JavaScript迭代器是一套协议，要求对象具有返回{value, done}对象的next()方法；可迭代对象则需实现[Symbol.iterator]方法以返回迭代器。
JavaScript 迭代器是什么：它不是对象，而是一个协议
迭代器（Iterator）在 JavaScript 中不是一个内置类或类型，而是一套约定：只要一个对象有 next() 方法，且该方法返回形如 { value: any, done: boolean } 的对象，它就是迭代器。这个协议被 for...of、Array.from()、展开运算符（[...iterable]）等消费。
注意：迭代器本身不一定是可迭代的（即不能直接用于 for...of），只有「可迭代对象（Iterable）」才支持。两者的区别常被混淆：
-
Iterator：有next()方法，一次吐一个值 -
Iterable：有[Symbol.iterator]()方法，调用后返回一个Iterator
如何让自定义对象变成可迭代对象：必须实现 [Symbol.iterator]
要让一个对象能被 for...of 遍历，你得给它加一个名为 [Symbol.iterator] 的方法（注意方括号是语法必需的，不是数组）。这个方法必须返回一个符合迭代器协议的对象。
常见错误写法：obj.iterator = function() { ... } —— 这不会被 for...of 识别，必须用 Symbol.iterator 这个键名。
立即学习“Java免费学习笔记（深入）”；
示例：一个简单计数器，从 0 到 2：
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
const counter = {
[Symbol.iterator]() {
let i = 0;
return {
next() {
if (i < 3) {
return { value: i++, done: false };
}
return { value: undefined, done: true };
}
};
}
};
<p>for (const n of counter) {
console.log(n); // 输出 0, 1, 2
}自定义可迭代对象时容易踩的坑
实际写的时候，这几个点最容易出问题：
-
next()必须每次调用都返回新对象，不能复用同一个对象引用（否则value和done可能被意外修改） -
[Symbol.iterator]必须是无参函数，且每次调用都应返回**新的迭代器实例**（否则多次遍历会共享状态，比如重复遍历时直接done: true） - 如果迭代逻辑依赖外部状态（如数组索引），确保闭包捕获的是当前迭代器的私有变量，而不是共享的父作用域变量
- 不要在
next()中抛错来表示结束——必须靠done: true；否则for...of会中断并报错
更实用的模式：用生成器函数替代手写 next()
手写 next() 容易出错且啰嗦。绝大多数场景下，直接用生成器函数（function*）是最简、最可靠的方式——它天然返回符合协议的迭代器。
上面的计数器用生成器重写：
const counter = {
[Symbol.iterator]: function* () {
for (let i = 0; i < 3; i++) {
yield i;
}
}
};生成器自动处理了 value/done 的组合、状态隔离、以及 return / throw 的兼容性。除非你需要精细控制迭代器的生命周期（比如手动暂停/恢复或注入外部事件），否则别手写 next()。
真正难的不是“怎么写”，而是想清楚：你的数据结构是否天然支持按需拉取？是否需要支持多次遍历？这些决定了你该返回一个新生成器，还是缓存一个已创建的迭代器。
