es-toolkit compat 的 unzip 详解：Lodash 兼容的数组解组、矩阵转置与结构化数据重组

es-toolkit compat 的 unzip 详解Lodash 兼容的数组解组、矩阵转置与结构化数据重组【免费下载链接】es-toolkitA modern JavaScript utility library thats 2-3 times faster and up to 97% smaller, a major upgrade to lodash.项目地址: https://gitcode.com/GitHub_Trending/es/es-toolkitunzip是 es-toolkit 兼容层es-toolkit/compat提供的 Lodash 兼容函数它把分组嵌套数组中处于相同位置的元素收集起来组成新数组是zip的逆操作常用于矩阵转置与结构化数据重组。本文以 docs/ja/compat/reference/array/unzip.md 为核心骨架结合 src/compat/array/unzip.ts 与 src/array/unzip.ts 的源码实现讲解其使用方式、边界行为、类型签名、与zip的互逆关系以及 compat 版与现代版在性能上的取舍帮助你写出可直接运行、类型安全且贴合实际场景的解组代码。一、unzip 是什么zip 的逆操作unzip接收一个已分组的二维数组将每个内部数组相同索引位置上的元素重新收集为新的数组并返回。换句话说它把行转换为列——这正是矩阵转置transpose操作因此它在处理表格类结构化数据、用户信息记录、多列统计结果时非常实用。在es-toolkit/compat中其基本调用形式为const result unzip(array);例如把混合了字符串、布尔值与数字的数组解组import { unzip } from es-toolkit/compat; const zipped [ [a, true, 1], [b, false, 2], ]; const result unzip(zipped); // 返回: [[a, b], [true, false], [1, 2]]原始数据中每一行代表一条记录如[a, true, 1]解组后每一列代表一个字段如[a, b]从而把按记录存储的数据转换为按字段存储的数据便于逐列统计或批量处理。二、基本使用从混合数组到用户数据1. 混合类型数组的解组以下示例展示了字符串、布尔值、数字混合数组的解组结果完整用例见 src/array/unzip.spec.tsimport { unzip } from es-toolkit/compat; const zipped [ [a, true, 1], [b, false, 2], ]; const result unzip(zipped); // 返回: [[a, b], [true, false], [1, 2]]2. 数字数组的矩阵转置const numbers [ [1, 4], [2, 5], [3, 6], ]; unzip(numbers); // 返回: [[1, 2, 3], [4, 5, 6]]3. 长度不一致的数组用 undefined 补齐解组结果的长度与最长的内部数组一致较短数组缺失的位置以undefined填充const uneven [ [a, 1], [b, 2, true], ]; unzip(uneven); // 返回: [[a, b], [1, 2], [undefined, true]]这一行为在 src/array/unzip.ts 的文档注释与 src/compat/array/unzip.spec.ts 的不同长度元组测试中均有明确验证unzip([[barney, 36], [fred, 40, false]])得到[[barney, fred], [36, 40], [undefined, false]]。4. 空值与空数组的处理与严格类型的现代版不同compat 版遵循 Lodash 习惯将null、undefined和空数组一律视为空数组返回import { unzip } from es-toolkit/compat; unzip(null); // [] unzip(undefined); // [] unzip([]); // []空数组场景同样覆盖在 src/array/unzip.spec.tsunzip([[], [], [], []])返回[]。5. 参数与返回值项说明参数arrayT[][] \| ArrayLikeArrayLikeT \| null \| undefined待解组的嵌套数组每个内部数组相同位置的元素会被收集。支持类数组对象array-like例如带length属性和数字索引的对象返回值T[][]相同位置元素收集而成的新数组若原数组长度不一较短数组的空缺位置以undefined填充三、compat 版与现代版性能取舍与选择建议使用es-toolkit/compat的unzip前官方文档给出了明确的警告优先使用es-toolkit的 unzip现代版。compat 版因为要处理null/undefined输入、过滤非数组值等 Lodash 兼容语义运行会相对更慢而现代版es-toolkit/array的unzip更快、更现代。两者的分工如下现代版src/array/unzip.ts面向类型严格的现代 TypeScript 代码参数类型为ReadonlyArray[...T]不做运行时防御只做纯解组计算性能最优compat 版src/compat/array/unzip.ts面向 Lodash 迁移场景兼容 Lodash 的宽松输入null/undefined、类数组对象、混入的非数组元素是功能对齐优先的实现函数式版src/fp/array/unzip.ts提供>export function unzipT(array: T[][] | ArrayLikeArrayLikeT | null | undefined): T[][] { if (!isArrayLikeObject(array) || !array.length) { return []; } array isArray(array) ? array : Array.from(array); array (array as T[][]).filter(item isArrayLikeObject(item)); return unzipToolkit(array as T[][]); }其关键步骤空值短路借助isArrayLikeObject判断输入是否为非 null 的类数组对象不是或长度为 0 时直接返回[]——这正是unzip(null)/unzip(undefined)/unzip([])都返回[]的实现依据类数组对象归一化若输入是类数组对象而非真数组如{ 0: {...}, length: 2 }通过Array.from转为真数组。对应测试见 src/compat/array/unzip.spec.ts过滤非数组元素filter(item isArrayLikeObject(item))剔除混入的非数组值这是 compat 版比现代版慢的原因之一委托核心逻辑把清洗后的数据交给现代版unzipToolkit来自 src/array/unzip.ts完成实际解组。五、现代版核心实现为什么它更快src/array/unzip.ts 是 compat 版背后真正的计算核心其性能优化体现在两处export function unzipT extends unknown[](zipped: ReadonlyArray[...T]): UnzipT { // For performance reasons, use this implementation instead of // const maxLen Math.max(...zipped.map(arr arr.length)); let maxLen 0; for (let i 0; i zipped.length; i) { if (zipped[i].length maxLen) { maxLen zipped[i].length; } } const result new Array(maxLen) as UnzipT; for (let i 0; i maxLen; i) { result[i] new Array(zipped.length); for (let j 0; j zipped.length; j) { result[i][j] zipped[j][i]; } } return result; }求最长长度不用展开运算符源码注释明确说明为了性能刻意避免Math.max(...zipped.map(arr arr.length))展开运算符在处理超长数组时可能触发参数数量上限改用普通for循环累比双重循环按列填充外层循环按列索引即最终结果的每个子数组遍历内层循环逐行取值zipped[j][i]实现矩阵转置。整个算法时间复杂度为 O(m × n)m 为内部数组个数n 为最长内部数组长度且只做直接索引赋值没有中间映射或flatMap开销。六、类型安全Unzip 映射类型与泛型推导现代版unzip的返回类型并非简单的T[][]而是通过映射类型推导出精确的元组结构见 src/array/unzip.tstype UnzipK extends unknown[] { [I in keyof K]: ArrayK[I] };这意味着输入Array[string, boolean, number]时返回值会被推导为[string[], boolean[], number[]]而非笼统的(string | boolean | number)[][]从而在解构时保留每个字段的精确类型const users [ [john, 30, engineer], [jane, 25, designer], [bob, 35, manager], ]; const [names, ages, roles] unzip(users); // names: string[], ages: number[], roles: string[]es-toolkit/compat的unzip为了兼容宽松输入签名退化为T[][]因此追求类型推导精度时同样建议使用es-toolkit/array的版本。英文参考文档 docs/reference/array/unzip.md 中也给出了解组用户信息后分别取出姓名、年龄、角色三列的示例。七、与 zip 的互逆关系及函数式用法unzip是 src/array/zip.ts 中zip的逆操作zip把多列合成行元组unzip再把行拆回多列。这一互逆性在测试中有直接验证见 src/compat/array/unzip.spec.ts// zip(...unzip(zip(...expected))) 能够还原原始数据 const expected [ [barney, fred], [36, 40], ]; unzip(zip(...unzip(zip(...expected)))) // 还原为 expectedzip的内部实现同样采用先循环求最大行数、再双重循环按列取值的结构src/array/zip.ts与unzip互为镜像。此外若你使用函数式风格可以从es-toolkit/fp引入>import { pipe, unzip } from es-toolkit/fp; pipe([[1, a], [2, b]] as Array[number, string], unzip()); // [[1, 2], [a, b]]八、总结es-toolkit/compat的unzip是一个典型的迁移友好函数它在行为上与 Lodash 对齐——宽容处理null/undefined/空数组、支持类数组对象、过滤非数组元素并把真正的高性能计算委托给现代版核心 src/array/unzip.ts。矩阵转置、按字段重组结构化数据、zip与unzip往返还原数据都是它的典型应用场景。从工程实践角度记住三条结论即可新代码优先用现代版es-toolkit/array的unzip类型推导更精确UnzipT映射类型、无运行时防御开销、性能更好迁移 Lodash 代码用 compat 版es-toolkit/compat的unzip行为与 Lodash 完全一致null/undefined/类数组对象都能正确处理函数式场景用 fp 版data-last 签名天然适配pipe组合参考 src/fp/array/unzip.ts 的示例。如果还想深入了解其在真实数据上的表现可查看 src/array/unzip.spec.ts 与 src/compat/array/unzip.spec.ts 的完整测试用例它们覆盖了空数组、不等长数组、类数组对象与 zip/unzip 互逆等全部边界场景。【免费下载链接】es-toolkitA modern JavaScript utility library thats 2-3 times faster and up to 97% smaller, a major upgrade to lodash.项目地址: https://gitcode.com/GitHub_Trending/es/es-toolkit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考