Array.prototype.flat()的核心作用是数组降维，将嵌套数组按指定深度展开为一维数组，从而让深层原始值“浮出水面”；它不转换或过滤元素，仅清除数组外壳，返回新数组。

Array.prototype.flat() 的核心作用是“降维”，但它本身不负责提取原始类型（如字符串、数字、布尔值等），而是把嵌套数组结构打平成一维数组。原始类型的提取，是在扁平化之后自然发生的——因为扁平后的数组元素中，原本被包裹在深层数组里的原始值就直接暴露出来了。

flat() 如何让原始值“浮出水面”

嵌套数据中，原始类型往往藏在多层数组或混合结构里。调用 flat() 后，所有子数组被递归展开（按指定深度），最终只剩最外层一个数组，其中每个元素都是不再被数组包裹的值——也就是你想要的原始类型（或对象、函数等非数组值）。

• 默认只展开一层：[1, [2, [3]]].flat() → [1, 2, [3]]（3 还在数组里，没被提取）
• 传入 Infinity 深度可彻底打平：[1, [2, [3, [4]]]].flat(Infinity) → [1, 2, 3, 4]，所有数字都成了顶层原始值
• 对含空槽或 undefined 的数组也有效：[1, , [2, undefined]].flat() → [1, 2, undefined]

注意：flat() 不过滤、不转换，只展开

它不会自动跳过对象、null 或函数，也不会把字符串数字转成数字。所谓“提取原始类型”，其实是你后续操作的事——flat() 只负责清除数组外壳，把值推到第一层。

• ['a', ['b', {c: 1}], [null, true]].flat(Infinity) → ['a', 'b', {c: 1}, null, true]（字符串、布尔、null、对象并存）
• 若只想保留原始类型，需配合 filter() 和 typeof：arr.flat(Infinity).filter(v => typeof v === 'string' || typeof v === 'number' || typeof v === 'boolean')

与 flatMap() 配合实现“边展平边提取”

如果嵌套结构不规则（比如有些项是数组、有些是原始值、还有些是 null），单独用 flat() 可能不够灵活。flatMap() 允许你先映射再扁平，更适合做预处理：

• [1, [2, 3], null, 'hello'].flatMap(x => Array.isArray(x) ? x : [x]) → [1, 2, 3, null, 'hello']
• 想跳过 null/undefined 并提取原始值：data.flatMap(x => x == null ? [] : (Array.isArray(x) ? x : [x])).filter(x => x !== null && x !== undefined)

常见陷阱提醒

别误以为 flat() 能处理类数组、Set、Map 或普通对象——它只对数组有效。遇到 NodeList 或 arguments，得先转成数组；遇到对象字段嵌套，得先用 Object.values() 或递归提取数组部分。

• Array.from(document.querySelectorAll('div')).flat() ✅（先转数组）
• Object.values({a: [1], b: [2, 3]}).flat() ✅（取值后再扁平）
• new Set([1, [2, 3]]).flat() ❌（Set 没有 flat 方法）