NodeJS 顺序遍历数组时如何通过setTimeout间隔执行命令

1. 触发报错的直接原因 #

setTimeout的第一个参数要求传入可执行的回调函数，你当前的写法是：

setTimeout(execCommand(commands[i]), 3000);

JS引擎会在代码执行到这行时立刻调用execCommand(commands[i])，拿到函数返回值（你的execCommand没有写return逻辑，实际返回undefined），最终传给setTimeout的是undefined，直接触发Callback must be a function的类型错误。

2. 逻辑层面的核心缺陷 #

就算把setTimeout的回调正确包裹为箭头函数、解决了类型报错，原有实现也满足不了你的需求：

• 基于固定时长的调度本质是“盲等”，git clone、git push这类网络IO操作的耗时受网络波动影响很大，根本没有监听前序命令是否执行完成，很容易出现上一条命令还没跑完，下一条依赖它结果的命令就提前启动的问题
• Node.js 的child_process.exec每次执行命令都会启动一个独立的shell进程，进程间不共享工作目录。也就是说单独执行cd ${repo}时，目录变更只会作用在临时的shell进程上，进程销毁后变更就失效，后续的git checkout、cp操作根本不会在repo目录下执行

整体逻辑遵循三个原则：

• 用Promise封装命令执行过程，拿到命令真正执行完成的明确信号，不依赖固定时长的盲等
• 解决shell进程间工作目录不共享的问题
• 在相邻命令的执行间隙插入3秒等待，满足你提的间隔要求

步骤1：封装支持异步等待的命令执行函数 #

把原本基于回调的exec转成可被await的Promise版本，明确捕获执行成功/失败的状态：

const a = require('debug')('worker:sucess');
const b = require('debug')('worker:error');
const { exec } = require('child_process');
const util = require('util');

// 转Promise版exec
const execAsync = util.promisify(exec);

async function execCommand(command, options = {}) {
  try {
    const { stdout, stderr } = await execAsync(command, {
      cwd: process.cwd(),
      ...options
    });
    a(`命令执行完成: ${command}`);
    if (stdout.trim()) a(stdout.trim());
    if (stderr.trim()) b(stderr.trim());
  } catch (err) {
    b(`命令执行失败: ${command}，错误详情: ${err.message}`);
    // 执行失败直接抛出异常，中断整个执行流程
    throw new Error(`命令执行失败，流程终止`);
  }
}

步骤2：实现顺序执行+间隔等待逻辑 #

// 3秒等待工具函数
const sleep = (waitTime) => new Promise(resolve => setTimeout(resolve, waitTime));

// 按顺序遍历执行命令数组
async function runSequentialCommands(commandList) {
  for (let index = 0; index < commandList.length; index++) {
    const currentCommand = commandList[index];
    // 等当前命令完全执行完成
    await execCommand(currentCommand);
    // 非最后一条命令，执行完后等3秒再启动下一条
    if (index < commandList.length - 1) {
      await sleep(3000);
    }
  }
}

// 启动执行流程
runSequentialCommands(commands)
  .then(() => a('所有命令按要求顺序执行完成'))
  .catch(err => b(err.message));

关键兼容提示 #

原命令数组中包含cd ${repo}、cd ../这类目录切换命令，这类命令在独立exec进程中不会保留状态，有两种兼容方案可选：

• 方案一：删除命令数组中所有cd相关的命令，把对应路径作为cwd配置参数传给execCommand，比如执行git checkout时直接指定工作目录为./${repo}
• 方案二：把所有命令用带间隔的分隔符拼接成单条shell指令，让所有命令在同一个shell会话中运行，目录变更会在会话内全局生效：

  // 拼接后的指令会在同一个shell中执行，相邻命令间自动插入3秒等待
  const fullCommand = commands.join(' && sleep 3 && ');
  await execCommand(fullCommand);
  

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