for循环中Promise如何运行？promiseMapLimit并发限制函数原理详解

核心变量作用 #

• ret：按输入数组顺序存储所有待执行的Promise实例，最终通过Promise.all汇总结果，保证输出顺序和输入一致
• executing：存储当前正在执行的异步任务对应的Promise，用来控制最大并发数

为什么for循环不会一次性遍历完全部100项 #

这是await关键字的特性导致的：
你设置的并发上限是20，前20次循环执行逻辑如下：

1. 每次循环生成一个新的Promise实例p，会自动触发iteratorFn的执行，同时按顺序把p推入ret数组
2. 给p绑定then回调：当p执行完成后，自动将当前任务从executing数组中移除，再把绑定了回调的Promise实例e推入executing数组
3. 前19次循环结束时，executing的长度从1增加到19，未达到20的上限，不会触发await逻辑，循环会正常继续
4. 第20次循环结束后，executing的长度刚好等于20，触发await Promise.race(executing)逻辑，此时整个async函数的执行会被暂停，for循环也会暂时卡住，直到executing数组中有任意一个Promise执行完成并resolve，才会恢复执行。

这就是你观察到只会遍历前20项的原因，不是不会遍历后面的项，是await把for流程暂时阻塞了。

后续并发控制逻辑 #

当有任意一个正在执行的任务完成时：

1. 该任务绑定的then回调先执行，把自己从executing数组中移除，此时executing的长度变为19
2. Promise.race(executing)返回结果，await阻塞解除，for循环恢复执行，开始遍历第21项
3. 第21项生成的新任务推入ret和executing后，executing长度又回到20，再次触发await阻塞

这个过程会一直持续到所有项都被遍历完成，全程最多只有20个异步任务同时运行，刚好实现并发限制的效果。

补充说明 #

这个逻辑实现的是「最大并发数限制」，不是「按固定分组执行」：只要有任务执行完成空出位置，就会立刻塞入下一个新任务，不需要等同一批的所有任务都执行完，比固定分组并发的资源利用率更高。

内容的提问来源于stack exchange，提问作者Karen