返回探索
指南VibeFix 内容整理更新于 2026年11月19日

别再用 for 循环硬写了:数组方法实战指南

菜单是一列菜,订单是一列已点的东西,算价格、筛过敏原、按销量排序全是数组的活。本文按 MDN 的《索引集合》指南讲清楚:建数组的坑、改不改原数组、map 与 filter、find 与 reduce、flat 与 groupBy、空位与类数组对象。

真实照片:一面贴满彩色便利贴的墙,粉、橙、黄、绿、蓝各色便签层层叠叠,像一列列数组元素

先把这篇的边界说清楚。站里已经有《Promise 与 async/await 实战指南》,讲的是等一个结果回来有几种写法;还有《事件循环实战指南》,讲的是代码排队执行的顺序;还有《闭包与作用域实战指南》,讲的是变量谁能看见。这篇不讲等结果、不讲排队、不讲变量,只讲一件事:手里有一列东西,怎么用数组方法把它加工成想要的样子。数组方法用对了,列表代码能短一半,也好读一半。下面用到的“青石咖啡馆”还是那个虚构的练手项目:一个帮街边咖啡馆做点单的网页小工具。这回讲的是它的菜单和订单列表:菜单是一列菜品,订单是一列已点的东西,算价格、筛过敏原、按销量排序,全是数组的活。本文所有以它为例的操作、代码和数字,都是为了讲清楚做法编出来的,不是真实记录。所有关于数组的语法和行为,都来自 MDN 的《Indexed collections(索引集合)》指南,来源见每篇的 meta 信息与 evidence 记录。MDN 文档里的例子,比如 Wind、Rain、Fire 三个字符串、asparagus 芦笋的库存清单、cats 猫咪数组,都是文档自带的示例,不是真实用户数据。

第一步:建数组先用方括号,Array(42) 不是装了一个 42

建数组最稳的写法,是方括号字面量:const arr3 = [element0, element1, elementN]。MDN 的原话是:方括号语法叫数组字面量,比其他创建方式更短,所以一般优先使用。也可以写 new Array 或者直接调 Array(),效果一样,但有一个大坑:传一个数字进去,它不表示“装一个这个数字”,而表示“数组长度是这个数”。MDN 的例子是:const arr = [42],得到的是只装了一个 42 的数组;而 const arr = Array(42),得到的是长度 42、里面一个元素都没有的数组。更危险的是传一个带小数点的数字:Array(9.3) 直接抛 RangeError:Invalid array length,因为长度不能是 9.3。

想稳妥地装一个任意类型、哪怕是数字的元素,有两个办法:用方括号 [9.3],或者用 Array.of(9.3),MDN 的例子就是后者,arr 里只装了一个 9.3。咖啡馆的菜单价格表就踩过这个坑:想建一个只装了 42 元这个价格的数组,写成了 Array(42),结果列表页渲染出 42 个空位,价格全是 undefined。记住第一句话:建数组默认写方括号;非要传单个数字,用 Array.of,别用 Array()。

第二步:下标从 0 开始,length 永远比最大下标大 1

JavaScript 的数组下标从 0 开始,不是从 1 开始。MDN 的例子是:const myArray = ["Wind", "Rain", "Fire"],第一个元素是 myArray[0],第二个是 myArray[1]。length 属性很特殊:它的值永远是最大下标加 1。MDN 的 cats 例子是:const cats = [],cats[30] = ["Dusty"],这时候 cats.length 是 31,因为最大下标是 30。中间 0 到 29 的位置,全是空位。

length 不光能读,还能写。写一个比现有元素个数小的值,数组会被截断;写 0,数组整个清空。MDN 的例子是:cats 是 ["Dusty", "Misty", "Twiggy"],长度 3;cats.length = 2 之后,数组变成 ["Dusty", "Misty"],Twiggy 被删掉了;cats.length = 0 之后,数组变成 [];再把 cats.length 写成 3,得到的是 3 个空位,不是什么都没有的 3 个 undefined——空位和 undefined 是两回事,后面第十一步会细讲。咖啡馆的订单列表清空按钮,用的就是 orders.length = 0,一行代码清空,比一个一个 pop 快得多,也干净得多。

下标还有一个容易忽略的规矩:下标必须是整数。MDN 的例子是:arr 是 [],写 arr[3.4] = "Oranges",数组的 length 还是 0,因为 3.4 不是下标,JavaScript 只是顺手在数组对象上挂了一个叫 3.4 的普通属性,Object.hasOwn(arr, 3.4) 读出来是 true。也就是说,数组在底层就是普通对象,下标只是属性名的一种;只有整数下标才算元素,其他写法挂上去的都是属性,不计入 length,也不会被 forEach、map 这些方法遍历到。调试的时候如果发现数组“明明有东西、length 却是 0”,先检查是不是有人往里面写了带小数点的下标,或者挂了别的属性名。

第三步:push、pop、shift、unshift——先分清改哪头、返回什么

往数组里加东西、拿东西出来,最常用的四个方法是 push、pop、shift、unshift。先分清改哪头:push 和 pop 管尾巴,shift 和 unshift 管开头。再分清返回什么:push 返回的是加完之后数组的新长度,pop 返回的是被拿掉的最后一个元素,shift 返回的是被拿掉的第一个元素,unshift 返回的是加完之后数组的新长度。MDN 的例子算得很清楚:myArray 是 ["1", "2"],push("3") 之后变成 ["1", "2", "3"];myArray 是 ["1", "2", "3"],pop() 拿掉 "3",数组剩下 ["1", "2"];shift() 拿掉 "1",数组剩下 ["2", "3"];unshift("4", "5") 之后数组变成 ["4", "5", "1", "2", "3"]。

新手最容易搞混的是返回值:push 返回的是长度,不是数组本身,所以 myArray = myArray.push("3") 会把数组写成数字 3,整个列表就毁了。咖啡馆的点单页就踩过这个坑:加菜的时候写了 orders = orders.push(dish),结果 orders 变成了 1,下一次加菜直接报错。记住判断句:push 和 unshift 返回长度,pop 和 shift 返回拿掉的元素;想拿到新数组,就别接返回值,直接用原数组。

第四步:concat、join、slice、at——不改原数组的四个帮手

不是所有数组方法都会改原数组。concat、join、slice、at 这四个,都是“看完就走,不动原数组”。concat 把两个或更多数组拼成一个新数组:MDN 的例子是 myArray 是 ["1", "2", "3"],concat("a", "b", "c") 之后得到 ["1", "2", "3", "a", "b", "c"],原数组没变。join 把所有元素拼成一个字符串:["Wind", "Rain", "Fire"].join(" - ") 得到 "Wind - Rain - Fire",菜单上的菜品列表就是这么拼成一行字显示的。

slice 是切一段出来,返回新数组:MDN 的例子是 ["a", "b", "c", "d", "e"].slice(1, 4) 得到 ["b", "c", "d"],从下标 1 开始切,到下标 4 之前停,含头不含尾,原数组还是五个元素。at 是按下标取值,专门用来取倒数的:myArray.at(-2) 就是倒数第二个元素 "d",越界了返回 undefined,不会报错。咖啡馆的“最近三单”就是这么写的:orders.slice(-3),不用算长度、不用怕越界,一行搞定。

第五步:splice、reverse、sort——这三个是原地改,小心别误伤

和上面四个相反,splice、reverse、sort 是原地改:它们改的就是原数组,返回的东西只是顺带。splice 是删一段、再插一段进去:MDN 的例子是 myArray 是 ["1", "2", "3", "4", "5"],splice(1, 3, "a", "b", "c", "d"),从下标 1 开始删 3 个,再把 a、b、c、d 插进去,数组变成 ["1", "a", "b", "c", "d", "5"],返回的是被删掉的 ["2", "3", "4"]。reverse 是原地翻转:["1", "2", "3"].reverse() 变成 ["3", "2", "1"],返回的还是同一个数组。

sort 是最容易踩坑的:默认按字符串排,不是按数字排。MDN 的例子是 ["Wind", "Rain", "Fire"].sort() 变成 ["Fire", "Rain", "Wind"],按字母顺序排的。如果数组里是数字,[10, 9, 80].sort() 不加比较函数,会按字符串排成 [10, 80, 9],因为 "10" 比 "80" 小、"80" 又比 "9" 小。MDN 的比较函数规则是:回调返回负数表示 a 排前面,返回正数表示 a 排后面,返回 0 表示两个相等、保持原顺序。MDN 按字符串最后一个字母排的例子是:sortFn 比较 a 和 b 最后一个字符,["Wind", "Rain", "Fire"] 排完变成 ["Wind", "Fire", "Rain"]。咖啡馆的菜单按价格排序,必须写 (a, b) => a.price - b.price,忘写比较函数,42 元的菜会排在 9 元前面,顾客一眼就看出来不对。

第六步:forEach——挨个跑一遍,但它什么都不返回

forEach 是最直白的迭代方法:你给它一个回调,它对数组里的每一项执行一次。MDN 的例子是:colors 是 ["red", "green", "blue"],colors.forEach((color) => console.log(color)),依次打印 red、green、blue。回调每次拿到当前元素,还能拿到下标和整个数组,但 forEach 的返回值永远是 undefined——它不是用来造新数组的,是用来“对每一项做点事”的,比如渲染列表、打日志、发请求。

还有两点要记住。第一,forEach 会跳过空位:稀疏数组里没填的位置,回调根本不会跑,第十一步会细讲。第二,MDN 明确提醒:不要用 for...in 遍历数组,因为数组元素在底层就是对象的属性,for...in 会把所有可枚举的属性都列出来,包括你顺手挂在数组上的额外属性。想遍历数组,用 for、for...of 或者 forEach,别用 for...in。咖啡馆的菜单渲染就是 forEach:每一项生成一个卡片,回调里只做渲染,不返回值,职责分得清清楚楚。

第七步:map 和 filter——造新数组的两把刀

map 和 filter 是数组方法里最常用的两个,两个都返回新数组,原数组不动。map 是“一对一变身”:对每一项跑一次回调,把回调的返回值收进新数组。MDN 的例子是:a1 是 ["a", "b", "c"],a1.map((item) => item.toUpperCase()) 得到 ["A", "B", "C"]。filter 是“按条件留人”:回调返回 true 的留下,返回 false 的扔掉。MDN 的例子是:a1 是 ["a", 10, "b", 20, "c", 30],a1.filter((item) => typeof item === "number") 得到 [10, 20, 30]。

flatMap 是 map 后面再跟一层 flat:MDN 的例子是 a1 是 ["a", "b", "c"],flatMap((item) => [item.toUpperCase(), item.toLowerCase()]) 得到 ["A", "a", "B", "b", "C", "c"]。菜单页的实战组合是:先 filter 把含过敏原的菜筛掉,再 map 把剩下的菜名转成大写显示。记住分工:要变身用 map,要筛选就用 filter,别在 forEach 里手动 push 一个新数组——那是把两个方法干的事,又用循环硬写了一遍。

第八步:find、findIndex 和它们的 Last 兄弟——找第一个,还是找最后一个

filter 返回的是所有符合条件的项,find 返回的是第一个符合条件的项本身。MDN 的例子是:a1 是 ["a", 10, "b", 20, "c", 30],a1.find((item) => typeof item === "number") 得到 10——第一个数字。findLast 则是从后往前找,同一个数组 findLast 得到 30——最后一个数字。findIndex 和 findLastIndex 返回的是下标,不是元素本身:findIndex 得到 1,findLastIndex 得到 5。

选哪个,看你要什么:要元素本身,用 find 或者 findLast;要下标,用 findIndex 或者 findLastIndex;要全部符合条件的,用 filter;只想知道有没有,用 some,下一节讲。找不着的时候,find 返回 undefined,findIndex 返回 -1,这两个返回值要分清:undefined 是“没找着元素”,-1 是“没找着下标”。咖啡馆的“找第一个缺货的菜”就是 find:找到就标红,找不着就返回 undefined,页面直接显示“全部有货”,不用再写一圈循环。

第九步:every、some、reduce——从一列东西里问出一个答案

every 和 some 是“问问题”的方法,返回 true 或者 false。every 是“是不是每一项都符合”:MDN 的例子是 isNumber 判断是不是数字,[1, 2, 3].every(isNumber) 是 true,[1, "2", 3].every(isNumber) 是 false,因为 "2" 是字符串。some 是“是不是至少有一项符合”:[1, "2", 3].some(isNumber) 是 true,["1", "2", "3"].some(isNumber) 是 false。菜单页的“是不是全部菜品都有图”用 every,“有没有哪道菜缺货”用 some,一眼就能看懂。

reduce 是把一列东西“攒”成一个值:MDN 的例子是 [10, 20, 30].reduce((accumulator, currentValue) => accumulator + currentValue, 0),结果是 60。initialValue 的规矩要记牢:给了 0,回调第一次的 accumulator 就是 0、currentValue 就是第一个元素;不给 initialValue,回调前两个参数就是数组的前两个元素,后面每次的第一个参数都是上一次回调的返回值。MDN 还提醒:reduce 和 reduceRight 是迭代方法里最不好懂的两个,只用在“把一列东西合并成一个值”的算法上。咖啡馆算订单总价就是 reduce:把每道菜的价格加起来,初始值写 0,别忘写——不写初始值,空订单会直接报错。

reduceRight 和 reduce 是一对,只是从最后一个元素开始往前攒。MDN 的原话是:reduceRight 和 reduce 的做法一样,只不过从最后一个元素开始。顺序无关的加法用哪个都一样;顺序有关的拼接,比如把一列字符串按从后往前的顺序拼起来,两个的结果完全不同。咖啡馆的“最近点过的菜”倒序展示就是 reduceRight 的活:从最后一单开始往前攒,攒出来的就是按时间倒排的清单。记住判断句:顺序无所谓就用 reduce,顺序要倒着来就用 reduceRight,别为了倒序再写一遍 reverse。

第十步:flat 和 groupBy——把嵌套摊平、把同类归堆

数组里套数组的时候,用 flat 摊平。MDN 的例子是:[1, 2, [3, 4]].flat() 得到 [1, 2, 3, 4],默认只摊一层;想多摊几层,传深度参数。分组的时候,用 Object.groupBy:MDN 的库存例子是 asparagus 是蔬菜、bananas 和 cherries 是水果、goat 和 fish 是肉,Object.groupBy(inventory, ({ type }) => type) 得到一个对象,vegetables、fruit、meat 三个键下面各挂着对应的数组。注意 MDN 的提醒:返回的对象里引用的还是原来的元素,不是深拷贝,改了里面的东西,原数组里的也会跟着变。

如果分组的键不能是字符串,比如键是一个会变的对象,就用 Map.groupBy,分组结果放进一个 Map,键可以是任意值。咖啡馆的菜单分组就是 groupBy:按 type 分成主食、饮品、甜点三组,页面上三个分区直接按组的键渲染,不用再写三遍筛选。记住分工:摊平用 flat,分组用 groupBy,别自己写循环一个一个往对象里塞。

第十一步:空位不是 undefined——稀疏数组最爱骗人

数组里的空位和 undefined 是两回事,MDN 专门花了一节讲这个。空位有五种造法:Array(5) 直接造 5 个空位;字面量里连写两个逗号 [1, 2, , , 5];往超过 length 的下标写值;直接把 length 拉长;用 delete 删掉某个元素。MDN 的例子是:arr 是 [1, 2, , , 5],arr[2] 读出来是 undefined,for...of 循环会打印 1、2、undefined、undefined、5,展开 [...arr] 得到 [1, 2, undefined, undefined, 5]——这些操作都把空位当成 undefined 来处理。

但迭代方法不这么看:同一个 arr,map((i) => i + 1) 得到 [2, 3, 空位, 空位, 6],空位还是空位;forEach 只打印 1、2、5,空位直接跳过;filter(() => true) 得到 [1, 2, 5],空位被扔掉了;some((k) => !k) 返回 false,因为空位根本没参与判断;Object.keys(arr) 只有 ["0", "1", "4"]。咖啡馆的菜单数组就是这么出事的:删菜用了 delete,数组里留了空位,map 渲染的时候空位还在,页面上多出一张空白卡片。记住判断句:删元素用 splice,别用 delete;想清空用 length = 0,别一个一个删。

第十二步:长得像数组的,不一定是数组

有些对象长得像数组,有 length,也能用下标访问,但不是数组,也没有数组的方法。MDN 举了两个:document.getElementsByTagName() 返回的 NodeList,和函数里的 arguments 对象。arguments 有 length,但没有 forEach,直接调 arguments.forEach 会抛 TypeError:arguments.forEach is not a function。MDN 给的办法是间接调用:Array.prototype.forEach.call(arguments, (item) => {...}),借数组原型上的方法来跑。

现代代码更常用的办法是先转成真数组再处理,比如用 Array.from 或者展开运算符,但道理是一样的:先确认它是不是真数组,再调数组方法。咖啡馆的点单页就踩过这个坑:querySelectorAll 返回的 NodeList,直接调 map 报错,改成先 Array.from 再 map 就好了。记住判断句:调方法之前先问一句“这是真数组吗”,Array.isArray 一测就知道,false 就先转、再调。

第十三步:120 次数组事故,先对着图自查

虚构青石咖啡馆项目一个月 120 次数组相关事故的原因分布条形图

上图是虚构的青石咖啡馆项目一个月的统计:和数组相关的事故一共 120 次。用错原地方法、不小心改了原数组 38 次,占 31.7%,是最多的;sort 没写比较函数、数字按字符串排错了 27 次,占 22.5%;稀疏数组的空位被跳过、页面多出空白卡片 22 次,占 18.3%;reduce 忘写初始值、空订单直接报错 19 次,占 15.8%;类数组对象直接调 forEach、抛 TypeError 14 次,占 11.7%。38 加 27 加 22 加 19 加 14 等于 120,账是平的。这些数字是编出来的例子,目的是让你一眼看到:第一类占了快三分之一,而它的根源只有一个——没分清“这个方法改不改原数组”。

自查清单:写完处理数组的代码,逐条打勾

第一,建数组默认写方括号,单个数字元素用 Array.of,别用 Array(数字)。第二,下标从 0 开始,length 永远是最大下标加 1,写 length 可以截断或者清空数组。第三,push 和 unshift 返回长度,pop 和 shift 返回拿掉的元素,别把返回值当成新数组。第四,concat、join、slice、at 不改原数组,splice、reverse、sort 原地改,用之前先问一句“它改不改原数组”。第五,sort 排数字必须写比较函数,返回负数、零、正数分别表示前面、相等、后面。第六,forEach 只做事不返回值,map 造新数组、filter 按条件留人,别在 forEach 里手动 push。第七,找元素用 find 或者 findLast,找下标用 findIndex 或者 findLastIndex,找不着返回 undefined 或者 -1。第八,问“是不是全部”用 every,问“有没有至少一个”用 some,攒成一个值用 reduce,初始值别忘写。第九,摊平用 flat,分组用 groupBy,分组结果引用的还是原元素、不是深拷贝。第十,删元素用 splice,别用 delete;空位不是 undefined,迭代方法会跳过它。第十一,调方法之前先确认是不是真数组,类数组对象先转成真数组再调;下标一定是整数,带小数点的下标挂上去的只是普通属性。十一条里任何一条答不上来,回到对应的章节再读一遍,比多背十个 API 都有用。

阅读 0评论 0

评论 (0)

ME
0/1000
评论加载中...

原始来源

浏览项目广场发布你的项目

相关文章

真实照片:一排浅灰色金属档案柜,其中一个抽屉拉开,露出里面一排排悬挂的文件夹
指南
浏览器里也能用数据库:IndexedDB 本地存取实战指南

localStorage 只能存字符串、没有索引。IndexedDB 是浏览器里真正的数据库:能存结构化数据、容量大得多、能建索引、能用事务。本文按 MDN 的《Using IndexedDB》《IDBDatabase》《IDBObjectStore》三篇官方文档讲清楚:五步套路、开库、升级、主键、索引、事务、add 与 put、get、游标、范围与多标签页升级。

工具技巧数据工作流前端工程
真实照片:一双手在 MacBook Pro 上打字,屏幕显示改写 HTML 内容的 JavaScript 代码,白色桌面上有白色鼠标、纸张和文件夹
指南
别让函数把你绕晕:JavaScript 函数、参数与箭头函数实战指南

函数你每天都在调,这篇把你一直在做的事讲清楚。本文按 MDN 的《Functions》《Arrow function expressions》《Rest parameters》三篇官方文档讲清楚:声明与表达式、参数与实参、默认值、剩余参数、展开语法、返回值、箭头函数省写规则、this 的坑、回调与高阶函数、作用域。

工具技巧前端工程AI 编程实践
真实照片:木桌上的笔记本电脑、平板与手机同时显示同一个绿叶主题网站,手机上导航已折成单列,桌角有一盆绿植
指南
手机上缩成一团?响应式布局与媒体查询实战指南

同一个页面要在手机、平板、电脑上都站得住。本文按 MDN 的《Responsive web design》《Using media queries》《viewport meta 参考》三篇官方文档讲清楚:流式 HTML、viewport 标签、流式网格与 max-width、图片不撑破容器、媒体查询语法、按内容定断点、mobile-first、响应式字号、按能力查设备与上线检查清单。

移动应用设计体验前端工程