Node.js/Javascript中如何实现串行队列以序列化函数执行？

1. 手动维护Promise队列（原生实现） #

通过维护一个全局Promise链，让每个新任务都追加到链的末尾，确保前一个任务完成后再执行下一个。这种方案完全基于Node.js原生API，无需额外依赖：

// 初始化已完成的Promise作为队列起点
let taskQueue = Promise.resolve();

function addToQueue(task) {
  // 将新任务链入队列，确保串行执行
  taskQueue = taskQueue.then(async () => {
    await task();
  }).catch(err => {
    // 捕获错误避免队列中断
    console.error('任务执行失败:', err);
  });
}

// 示例串行函数
async function funcA() {
  console.log('启动funcA');
  await new Promise(resolve => setTimeout(resolve, 1000));
  console.log('完成funcA');
}

async function funcB() {
  console.log('启动funcB');
  await new Promise(resolve => setTimeout(resolve, 500));
  console.log('完成funcB');
}

async function funcC() {
  console.log('启动funcC');
  await new Promise(resolve => setTimeout(resolve, 800));
  console.log('完成funcC');
}

// 将任务加入队列
addToQueue(funcA);
addToQueue(funcB);
addToQueue(funcC);

2. async/await配合循环（适用于固定任务列表） #

如果三个函数是明确的、可提前整理为列表的，直接用for...of循环结合async/await即可实现串行：

async function runSequentially() {
  const tasks = [funcA, funcB, funcC];
  for (const task of tasks) {
    await task();
  }
}

runSequentially();

该方式逻辑直观，适合任务数量固定、无需动态添加的场景。

3. 借助第三方库（如p-queue） #

若需要更复杂的队列控制（比如优先级、暂停/恢复、超时处理等），可以使用成熟的第三方库p-queue，只需设置并发数为1即可实现串行：

const PQueue = require('p-queue');
const queue = new PQueue({ concurrency: 1 });

// 添加任务到队列
queue.add(funcA);
queue.add(funcB);
queue.add(funcC);

关键注意事项 #

• 无论采用哪种方案，都要处理任务执行中的错误，避免单个任务失败导致整个队列中断（比如用try/catch包裹await，或在Promise链中添加catch）。
• 同步函数和异步函数都能适配上述方案，异步函数会等待内部异步操作完成后再执行下一个任务。

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