在 npm scripts 中执行串行任务,最标准且推荐的做法是利用 npm 内置的依赖解析机制,通过在 package.json 的 scripts 字段中直接引用其他脚本名称来实现。当你在一个脚本命令中列出多个脚本名(以空格分隔)时,npm 会按顺序依次调用它们,前一个脚本成功退出后才会启动下一个;如果中间任何一步失败,后续步骤将立即停止。这种方式比使用第三方工具如 concurrently 或 run-s 更轻量,因为它不需要额外的安装依赖,且能原生处理退出码和错误中断逻辑。

如何配置 package.json 实现基础串行调用
要实现基础的串行调用,只需在 package.json 文件中定义你的主脚本,并将需要按顺序执行的子脚本名称作为值填入。例如,假设你有一个构建流程,需要先清理旧文件,再编译代码,最后运行测试,你可以这样配置:
{
"name": "my-project",
"version": "1.0.0",
"scripts": {
"clean": "rm -rf dist",
"build": "tsc",
"test": "jest",
"start": "node server.js"
}
}现在,如果你希望先清理、再构建、最后启动服务,你可以定义一个新的脚本 deploy:
{
"scripts": {
// ... 其他脚本 ...
"deploy": "clean build start"
}
}当你运行 npm run deploy 时,npm 会首先执行 npm run clean,等待其完成后,再执行 npm run build,最后执行 npm run start。这种写法简洁明了,是处理简单串行任务的首选方案。需要注意的是,这里的脚本名必须与 scripts 对象中的键完全匹配,且不支持在脚本名之间添加参数传递,如果需要传递参数,需结合 shell 语法或使用其他工具。
立即学习“Java免费学习笔记(深入)”;

如何处理并行任务与混合场景
虽然 npm 原生支持串行,但在实际项目中,经常需要并行执行某些独立任务,或者在串行流程中插入并行步骤。此时,推荐使用社区广泛使用的 npm-run-all 包(提供 run-p 和 run-s 命令)。其中 run-s 用于串行,run-p 用于并行。安装该包后:npm install --save-dev npm-run-all。
例如,假设你有两个独立的 lint 检查任务:前端代码检查和后端代码检查,它们可以并行执行以提高速度,但都必须在构建之前完成。你可以这样配置:
{
"scripts": {
"lint:frontend": "eslint src/",
"lint:backend": "eslint backend/",
"lint:all": "run-p lint:frontend lint:backend",
"build": "webpack",
"prebuild": "run-s lint:all clean",
"dev": "run-p watch:frontend watch:backend"
}
}在这个例子中,prebuild 脚本会在 build 之前自动执行。它先串行执行 lint:all(内部并行执行两个 lint 任务)和 clean。而 dev 脚本则并行启动前后端的监听进程。这种混合用法使得复杂的项目流程管理变得灵活且可控。使用 npm-run-all 的优势在于它可以清晰地表达并行与串行的意图,并且支持通配符和更复杂的条件执行。

当串行任务中某一步失败时,后续任务会怎样执行
在 npm 原生的串行执行机制中,错误处理是严格遵循“短路”原则的。如果在一个由空格分隔的脚本列表中,任何一个子脚本以非零退出码结束(即发生错误),npm 会立即终止整个序列,不再执行后续的脚本。这意味着,如果你的 deploy 脚本定义为 clean build start,而 build 步骤因为编译错误失败了,那么 start 步骤将永远不会被触发。
这种行为对于确保数据一致性和系统稳定性至关重要。例如,在部署场景中,如果构建失败,继续启动服务可能会导致服务指向错误的或未完成的代码版本。为了验证这一点,我们可以创建一个简单的测试场景:
{
"scripts": {
"step1": "echo 'Step 1' && exit 0",
"step2": "echo 'Step 2' && exit 1",
"step3": "echo 'Step 3'",
"fail-test": "step1 step2 step3"
}
}运行 npm run fail-test 后,控制台会输出:
Step 1 Step 2 npm ERR! code ELIFECYCLE npm ERR! errno 1 npm ERR! my-project@1.0.0 step2: `echo 'Step 2' && exit 1` npm ERR! Exit status 1 npm ERR! npm ERR! Failed at the my-project@1.0.0 step2 script. npm ERR! This is probably not a problem with npm. There is likely additional logging output above. npm ERR! A complete log of this run can be found in: npm ERR! /path/to/log/file.log npm ERR! Code: ELIFECYCLE npm ERR! Command: /usr/local/bin/node /usr/local/bin/npm run step2 npm ERR! Failed at script: step2 npm ERR! Failed at script: fail-test
可以看到,Step 3 没有被打印出来,证明 step3 未被执行。这种默认行为确保了错误能够迅速暴露,防止问题扩散。如果需要忽略某个步骤的错误并继续执行,可以使用 shell 的 || true 技巧,但这通常不推荐,除非你明确知道如何处理潜在的风险。


















