JavaScript迭代器是遵循特定协议的函数对象，必须有next()方法并返回{value, done}对象，支持按需生成值；可迭代对象则需实现[Symbol.iterator]方法并返回迭代器。
JavaScript 迭代器（Iterator）到底是什么？
迭代器不是语法糖，也不是对象类型，而是一个**约定接口的函数对象**：它必须有 next() 方法，每次调用返回一个形如 { value: ..., done: true|false } 的对象。只要满足这个协议，任何对象都可以是迭代器。
关键点在于「按需生成」——next() 不是预计算全部值，而是每次只产出下一个值，这对处理大数据流、无限序列或异步数据特别有用。
-
done: true表示迭代结束，之后再调用next()仍应返回{ value: undefined, done: true } - 迭代器本身不一定要可重复使用；多数原生迭代器（如数组的
[Symbol.iterator]()）只支持单次遍历 - 不能直接
for...of一个裸迭代器对象，必须先确保它符合「可迭代协议」（见下节）
哪些对象是可迭代对象（Iterable）？
可迭代对象 ≠ 迭代器，而是指实现了 [Symbol.iterator] 方法的对象，该方法必须返回一个迭代器。只有可迭代对象才能用于 for...of、展开运算符 [...iterable]、解构、Array.from() 等场景。
常见可迭代对象包括：
立即学习“Java免费学习笔记（深入）”；
- 数组
[]、字符串"abc"、TypedArray（如Uint8Array） -
Map、Set、WeakMap、WeakSet（注意：WeakMap/WeakSet不可枚举，但仍是可迭代对象） -
arguments对象、NodeList（DOM 查询结果，如document.querySelectorAll('div')） -
Generator函数返回值（天生可迭代，且自身就是迭代器） - 自定义对象：只要手动挂上
[Symbol.iterator]() { return {...} }就行
反例：普通对象 {}、null、undefined、Promise、Function 默认都不是可迭代对象，直接用于 for...of 会报 TypeError: xxx is not iterable。
你是 TypeScript 项目架构专家，专注于脚手架搭建生产就绪的 Node.js 和前端应用。生成包含现代工具链（pnpm、Vite、Next.js）、类型
如何手写一个可迭代对象？
核心就两步：1）定义 [Symbol.iterator] 方法；2）该方法返回一个符合迭代器协议的对象。下面是一个计数器示例，生成 0 到 2 的整数：
const counter = {
[Symbol.iterator]() {
let i = 0;
return {
next() {
if (i < 3) {
return { value: i++, done: false };
} else {
return { value: undefined, done: true };
}
}
};
}
};
for (const num of counter) {
console.log(num); // 0, 1, 2
}
注意点：
- 不要在
[Symbol.iterator]外层保存状态（如let i = 0放在对象字面量外），否则多个for...of循环会共享状态，导致不可预期行为 - 如果想支持多次遍历，每次调用
[Symbol.iterator]都应返回一个**新迭代器实例** - 若需异步迭代，要用
[Symbol.asyncIterator]和async function*，那是另一套协议
常见错误：为什么 Map/Set 的 key 是可迭代的，但 Object 不是？
因为 Map.prototype.keys()、Set.prototype.values() 等方法返回的是迭代器对象，而 Object 没有内置 [Symbol.iterator] 方法。你不能写 for (const key of {}) {...}，但可以写 for (const key of Object.keys({})) {...} —— 因为 Object.keys() 返回的是数组，数组是可迭代的。
容易混淆的点：
-
Object.entries(obj)返回数组，所以可直接for...of；但obj本身不行 -
Map和Set的迭代顺序是插入顺序；Object的keys()在 ES2015+ 也保证属性插入顺序（仅限字符串/符号键，不含数字键排序干扰） - 试图对
JSON.parse()后的普通对象用展开运算符会失败：{...obj}合法，但[...obj]报错，因为后者触发可迭代协议检查
真正需要遍历对象时，别硬凑迭代器，优先用 Object.keys()、Object.values()、Object.entries()，它们稳定、语义清晰，且返回的数组天然可迭代。
