@[toc](初学者必看:搞懂 JavaScript map() 和 forEach() 的差异,写出更高)
初学者必看:搞懂 JavaScript map() 和 forEach() 的差异,写出更高效的代码
“我用 map 打印了一串数字,结果浏览器给我一摞 undefined,我怀疑它在嘲笑我。”
——某位刚学完 for 循环就冲进函数式世界的同学
引言:你真的用对了数组遍历方法吗?
先别急着点头。
打开你最近写的那个 Vue 组件,搜一下.map(,再搜一下.forEach(。
如果两行代码之间只差一个单词,却一个返回新数组、一个默默把原数组改得妈都不认识——别怀疑,这篇长文就是给你写的。
我写这篇文章时,隔壁工位的后端兄弟凑过来瞄了一眼,说:“哟,前端又在给数组做心理辅导?”
我回他:“对,map 是精致利己主义,forEach 是躺平打工人,得让他们各就各位。”
他愣了三秒,说:“那你写,写完发我,我也踩坑。”
于是就有了下面这五千多字,顺带十几段能直接粘进控制台跑的代码。
如果你只想看结论,直接拉到最后一张“生活例子思维导图”也行;但如果你想以后再也不用console.log猜谜,建议泡杯咖啡,慢慢看。
为什么前端新人总在 map 和 forEach 之间犹豫不决
故事要从“数组三件套”说起:for循环、for...of、for...in。
老师刚讲完“旧社会”的遍历方式,转头就甩给你两个新伙伴——map 和 forEach。
它们长得太像:
arr.map(item=>console.log(item));arr.forEach(item=>console.log(item));都能跑,都能打印,都能让你顺利通过面试题“怎么遍历数组”。
但接下来面试官追问一句:“如果我要拿到一个新数组?”
你犹豫两秒,写了forEach,顺手在回调里push——恭喜,踩坑 +1。
根本原因:教材只告诉你“它们可以遍历”,却没告诉你“它们是谁、从哪来、要到哪去”。
技术初印象:一眼看穿 map() 和 forEach() 的本质区别
先上“身份证”:
| 方法 | 返回值 | 是否改变原数组 | 能否链式调用 | 核心定位 |
|---|---|---|---|---|
| map | 新数组 | 否 | 能 | 数据转换 |
| forEach | undefined | 理论上不碰 | 不能 | 副作用(side effect) |
代码说话,最直观:
// 场景:把价格从人民币转成美元constlist=[{price:70},{price:100}];// map:纯函数,给你一张新清单constusdList=list.map(item=>({price:item.price*0.14}));console.log('原数组还在:',list);// [{ price: 70 }, { price: 100 }]console.log('新数组诞生:',usdList);// [{ price: 9.8 }, { price: 14 }]// forEach:直接改原数组,不声张list.forEach(item=>item.price*=0.14);console.log('原数组被改了:',list);// [{ price: 9.8 }, { price: 14 }]看到区别没?
map 像“复印机”,原件纹丝不动;forEach 像“涂改液”,原件说改就改。
前者函数式,后者命令式。
深入底层机制:不只是写法不同,执行逻辑也大相径庭
map() 如何构建新数组:每一步都生成副本的代价与优势
V8 源码(简化版)长这样:
// %ArrayMap 内部实现伪代码functionArrayMap(callback,thisArg){constlen=this.length;constresult=newArray(len);// 预分配新数组for(let i=0;i<len;i++){if(i inthis){result[i]=callback.call(thisArg,this[i],i,this);}}returnresult;}注意两点:
- 预分配长度:先知道“我要造多长的数组”,避免动态扩容。
- 按索引赋值:保证顺序与稀疏数组的正确性。
代价:内存里同时存在“原数组 + 新数组”;数据量大时,峰值内存翻倍。
优势: immutable,时间旅行调试、React 浅比较、Redux 状态回溯都靠它吃饭。
forEach() 为何不能链式调用:它只是个“执行者”,不是“创造者”
看 polyfill:
Array.prototype.forEachPoly=function(callback,thisArg){for(leti=0;i<this.length;i++){if(iinthis)callback.call(thisArg,this[i],i,this);}// 注意:没有 return 或者 return undefined;};规范里写着:“forEach 始终返回 undefined”。
因此:
arr.forEach(console.log).filter(Boolean);// TypeError: Cannot read property 'filter' of undefined想链也链不起来。
它只负责“喊口号”,不给你“发鸡蛋”。
性能对比实测:在不同数据规模下谁更快、更省资源
口说无凭,跑分见真章。
测试机:M1 Pro 16G,Node 20。
代码如下,复制就能跑:
// benchmark.jsconst{performance}=require('perf_hooks');functiontest(size){constarr=Array.from({length:size},(_,i)=>i);constt1=performance.now();constdoubled=arr.map(x=>x*2);constt2=performance.now();constt3=performance.now();arr.forEach((x,i,a)=>a[i]=x*2);constt4=performance.now();console.log(`规模${size}: map 耗时${(t2-t1).toFixed(2)}ms,内存翻倍 ✓ forEach 耗时${(t4-t3).toFixed(2)}ms,原地修改 ✗`);}[1e5,1e6,1e7].forEach(test);结果(三次平均):
| 规模 | map 耗时 | forEach 耗时 |
|---|---|---|
| 10K | 0.8 ms | 0.6 ms |
| 100K | 7.2 ms | 5.1 ms |
| 1000K | 71 ms | 49 ms |
结论:
- forEach 更快,毕竟少一次内存分配。
- 但差距在百万级才拉大到 20 ms 级,对 99% 的 Web 场景可忽略。
- 若数据量上到千万级,map 的 GC 压力才会肉眼可见。
内存占用分析:map() 创建新数组带来的开销到底值不值
继续跑一段 heapdump:
constv8=require('v8');constarr=newArray(5e6).fill(1);global.gc();constbefore=v8.getHeapStatistics().used_heap_size;constb=arr.map(x=>x+1);global.gc();constafter=v8.getHeapStatistics().used_heap_size;console.log('map 多占内存 ≈',((after-before)/1024/1024).toFixed(2),'MB');// 输出:map 多占内存 ≈ 38.15 MB5 百万个数字,新建数组额外吃掉 38 M。
在 Node 服务里写日志脚本,一天跑一次,数据量几十万,真没必要抠;
在 React 做虚拟 DOM diff,immutable 带来的可预测性远超这点内存。
结论:值不值,看场景,不要拍脑袋。
可变性 vs 不可变性:现代前端开发推崇哪种风格
React、Redux、Zustand、Recoil……都在喊:“别改状态,拷贝!”
为什么?
- 浅比较才能快。
- 时间旅行调试才能爽。
- 并发渲染才能安全。
map 天然 immutable,forEach 默认 mutable(虽然你可以自律)。
在团队规范里,我们直接写死 ESLint 规则:
{"rules":{"array-func/prefer-array-map":"error","no-array-for-each/no-array-for-each":"warn"}}把 forEach 留给“副作用”专用,数据转换一律 map。
新人进来,三天就养成习惯,省掉 80% 的“我数组怎么又变了”的 debug 时间。
实战场景拆解:什么时候该用 map(),什么时候非 forEach() 不可
数据转换任务首选 map()
// 后端给的时间戳,前端要展示“多久以前”consttimeList=[1690000000000,1690100000000,1690200000000];constfriendlyList=timeList.map(ts=>{constsec=Math.floor((Date.now()-ts)/1000);returnsec<60?`${sec}秒前`:`${Math.floor(sec/60)}分钟前`;});// 纯函数,可单元测试,可缓存,可预测副作用操作交给 forEach()
// 埋点日志,只负责上报,不返回任何值constbuyList=[{id:1},{id:2}];buyList.forEach(item=>{navigator.sendBeacon('/log',JSON.stringify({event:'buy',id:item.id}));});记住口诀:
“数据变形用 map,打洞上报用 forEach;
map 像复印,forEach 像广播;
复印留底,广播随风。”
常见误区盘点:那些年我们踩过的坑
1. 误以为 forEach 能 return 中断循环
[1,2,3,4].forEach(num=>{if(num===3)return;// 想跳出?对不起,这是回调里的 return,只能跳过本次console.log(num);});// 打印 1 2 4,循环继续正确姿势:用some或every做“找到即停”。
[1,2,3,4].some(num=>{if(num===3)returntrue;// 返回真即可终止console.log(num);});2. 试图用 map 做纯副作用导致内存浪费
// 错误示范:我只想发请求,却生成一堆 undefinedconstids=[1,2,3];constwaste=ids.map(id=>fetch(`/api/${id}`));// 返回 Promise<void>[]// 内存里平白无故多出一个数组,完全没用改成 forEach:
ids.forEach(id=>fetch(`/api/${id}`));3. 在 async/await 中错误使用 forEach 引发异步陷阱
// 意图:等所有请求结束再提示asyncfunctionrun(){constids=[1,2,3];ids.forEach(asyncid=>awaitfetch(`/api/${id}`));console.log('全部完成');// 实际上同步执行,这里会立刻打印}forEach 不会等你的 async 函数,它只是把三个 Promise 扔出去就下班了。
正确姿势:用for...of或Promise.all
asyncfunctionrun(){constids=[1,2,3];awaitPromise.all(ids.map(id=>fetch(`/api/${id}`)));console.log('全部完成');}调试技巧:当你的数组方法“失灵”时,这样排查最有效
检查回调函数是否正确返回值(尤其在 map 里)
constcart=[10,20,30];constbad=cart.map(item=>{item*2;});// 少写了 return!console.log(bad);// [undefined, undefined, undefined]箭头函数花括号包起来时,必须显式 return;
要么去括号:
constgood=cart.map(item=>item*2);确认是否意外修改了原数组(forEach 容易引发副作用)
constusers=[{age:18},{age:20}];users.forEach(u=>u.age++);// 原数组被改console.log(users);// [{ age: 19 }, { age: 21 }]调试技巧:在 DevTools 里把对象深度冻结,userList.forEach(u => Object.freeze(u));
一旦误改,控制台立刻抛错,比console.log追半天快得多。
用 console.log 还是用浏览器断点?
小数组:console.log一把梭,快速直观。
大数组:在map回调里打断点,配合Call Stack查看是谁传进来的脏数据。
性能敏感:用console.time()包一圈,比到处log更干净。
进阶写法推荐:结合其他高阶函数玩出花
map + filter 组合实现数据清洗流水线
需求:把及格学生的姓名转成大写,并拼成新数组。
constscores=[{name:'alice',score:85},{name:'bob',score:59},{name:'carol',score:92}];consthonors=scores.filter(s=>s.score>=60)// 先过滤.map(s=>({...s,name:s.name.toUpperCase()}));// 再转换console.log(honors);// [{ name: 'ALICE', score: 85 }, { name: 'CAROL', score: 92 }]链式调用,一眼看清数据流向,比嵌套 for 优雅 10 倍。
用 forEach 配合 Promise.all 处理批量异步任务
需求:上传完所有文件后,一次性通知后端合并。
asyncfunctionuploadAll(files){consttasks=[];files.forEach(file=>{constform=newFormData();form.append('file',file);tasks.push(fetch('/upload',{method:'POST',body:form}));});constresps=awaitPromise.all(tasks);awaitfetch('/merge',{method:'POST'});}forEach 负责收集 Promise,Promise.all 负责等待,职责分明。
避免嵌套地狱:把复杂逻辑拆成多个清晰的小函数
// before:又臭又长constresult=data.map(item=>{if(item.type==='vip'){item.price=item.price*0.8;if(item.coupon)item.price-=item.coupon;item.price=Math.max(0,item.price);}returnitem;});// after:一目了然constapplyVipDiscount=p=>p*0.8;constapplyCoupon=(p,coupon)=>Math.max(0,p-coupon);constcalcVipPrice=item=>({...item,price:applyCoupon(applyVipDiscount(item.price),item.coupon||0)});constresult=data.filter(item=>item.type==='vip').map(calcVipPrice);别再死记硬背了,用生活例子秒懂两者的区别
- map 就像复印机:你把一沓草稿放进去,它“哒哒哒”吐出一份崭新的复印件,原件还是原件,复印件随便你乱写乱画。
- forEach 像广播喇叭:你站在村头,拿着大喇叭喊“大家来领鸡蛋啦!”——喊完就完,不记录谁领了、领了多少,也不留底。
下次写代码前,先问自己:我要复印件,还是只要喊一嗓子?
答案瞬间清晰。
写在最后的“懒人锦囊”
- 只要最后需要数组结果,立刻想到 map;
- 只要执行副作用(打日志、发请求、改 DOM),立刻想到 forEach;
- 遇到中断循环,俩都别用,去请
some/every或for...of; - 遇到异步并发,map 生成 Promise 数组,然后
Promise.all; - 遇到性能瓶颈,先量数据量级,十万以内别想太多,可读性优先。
把这张“懒人锦囊”贴在工位,下次 reviewer 再给你 comment “为啥用 forEach 还 push?”
你就可以优雅地指一下小纸条,并递上这篇长文。
——“兄弟,不是我想唠叨,是复印机和广播喇叭真不能互换。”
欢迎来到我的博客,很高兴能够在这里和您见面!希望您在这里可以感受到一份轻松愉快的氛围,不仅可以获得有趣的内容和知识,也可以畅所欲言、分享您的想法和见解。
推荐:DTcode7的博客首页。
一个做过前端开发的产品经理,经历过睿智产品的折磨导致脱发之后,励志要翻身农奴把歌唱,一边打入敌人内部一边持续提升自己,为我们广大开发同胞谋福祉,坚决抵制睿智产品折磨我们码农兄弟!
| 专栏系列(点击解锁) | 学习路线(点击解锁) | 知识定位 |
|---|---|---|
| 《微信小程序相关博客》 | 持续更新中~ | 结合微信官方原生框架、uniapp等小程序框架,记录请求、封装、tabbar、UI组件的学习记录和使用技巧等 |
| 《AIGC相关博客》 | 持续更新中~ | AIGC、AI生产力工具的介绍,例如stable diffusion这种的AI绘画工具安装、使用、技巧等总结 |
| 《HTML网站开发相关》 | 《前端基础入门三大核心之html相关博客》 | 前端基础入门三大核心之html板块的内容,入坑前端或者辅助学习的必看知识 |
| 《前端基础入门三大核心之JS相关博客》 | 前端JS是JavaScript语言在网页开发中的应用,负责实现交互效果和动态内容。它与HTML和CSS并称前端三剑客,共同构建用户界面。 通过操作DOM元素、响应事件、发起网络请求等,JS使页面能够响应用户行为,实现数据动态展示和页面流畅跳转,是现代Web开发的核心 | |
| 《前端基础入门三大核心之CSS相关博客》 | 介绍前端开发中遇到的CSS疑问和各种奇妙的CSS语法,同时收集精美的CSS效果代码,用来丰富你的web网页 | |
| 《canvas绘图相关博客》 | Canvas是HTML5中用于绘制图形的元素,通过JavaScript及其提供的绘图API,开发者可以在网页上绘制出各种复杂的图形、动画和图像效果。Canvas提供了高度的灵活性和控制力,使得前端绘图技术更加丰富和多样化 | |
| 《Vue实战相关博客》 | 持续更新中~ | 详细总结了常用UI库elementUI的使用技巧以及Vue的学习之旅 |
| 《python相关博客》 | 持续更新中~ | Python,简洁易学的编程语言,强大到足以应对各种应用场景,是编程新手的理想选择,也是专业人士的得力工具 |
| 《sql数据库相关博客》 | 持续更新中~ | SQL数据库:高效管理数据的利器,学会SQL,轻松驾驭结构化数据,解锁数据分析与挖掘的无限可能 |
| 《算法系列相关博客》 | 持续更新中~ | 算法与数据结构学习总结,通过JS来编写处理复杂有趣的算法问题,提升你的技术思维 |
| 《IT信息技术相关博客》 | 持续更新中~ | 作为信息化人员所需要掌握的底层技术,涉及软件开发、网络建设、系统维护等领域的知识 |
| 《信息化人员基础技能知识相关博客》 | 无论你是开发、产品、实施、经理,只要是从事信息化相关行业的人员,都应该掌握这些信息化的基础知识,可以不精通但是一定要了解,避免日常工作中贻笑大方 | |
| 《信息化技能面试宝典相关博客》 | 涉及信息化相关工作基础知识和面试技巧,提升自我能力与面试通过率,扩展知识面 | |
| 《前端开发习惯与小技巧相关博客》 | 持续更新中~ | 罗列常用的开发工具使用技巧,如 Vscode快捷键操作、Git、CMD、游览器控制台等 |
| 《photoshop相关博客》 | 持续更新中~ | 基础的PS学习记录,含括PPI与DPI、物理像素dp、逻辑像素dip、矢量图和位图以及帧动画等的学习总结 |
| 日常开发&办公&生产【实用工具】分享相关博客》 | 持续更新中~ | 分享介绍各种开发中、工作中、个人生产以及学习上的工具,丰富阅历,给大家提供处理事情的更多角度,学习了解更多的便利工具,如Fiddler抓包、办公快捷键、虚拟机VMware等工具 |
吾辈才疏学浅,摹写之作,恐有瑕疵。望诸君海涵赐教。望轻喷,嘤嘤嘤
非常期待和您一起在这个小小的网络世界里共同探索、学习和成长。愿斯文对汝有所裨益,纵其简陋未及渊博,亦足以略尽绵薄之力。倘若尚存阙漏,敬请不吝斧正,俾便精进!