VS Code tasks.json 怎么把格式化和测试串成一个任务

如果每次保存代码都要先手动格式化，再从任务菜单启动测试，可以把两步封装成一个 VS Code 组合任务。关键配置是让组合任务通过 dependsOn 找到两个子任务，再用 dependsOrder: "sequence" 明确按顺序执行；最后把它放进 build 组并设为默认任务，就能用“运行生成任务”启动。

先把两个脚本写成独立任务

先确认项目的 package.json 中已经存在 format 和 test 脚本。打开 VS Code 的工作区后，依次点击 Terminal → Configure Tasks → Create tasks.json from template → Others。如果项目已有这个文件，直接在 Explorer 中打开 .vscode/tasks.json 即可。

先写两个可以单独运行的任务，再写组合任务，排错时更容易判断究竟是格式化脚本还是测试脚本失败：

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "Format",
      "type": "shell",
      "command": "npm run format",
      "problemMatcher": []
    },
    {
      "label": "Test",
      "type": "shell",
      "command": "npm test",
      "problemMatcher": []
    }
  ]
}

这里的 label 是任务选择器中显示的名称，command 是实际执行的命令。problemMatcher 先保持为空，避免把普通测试输出误当成编译器诊断；如果格式化脚本同时运行 ESLint，再按该工具的输出格式绑定匹配器。

用 dependsOrder 让执行顺序可控

在同一个 tasks 数组里新增组合任务。dependsOn 写依赖任务的 label，而不是脚本命令；多个依赖项默认可以并行，所以这里必须增加顺序配置：

{
  "label": "Format and Test",
  "dependsOn": ["Format", "Test"],
  "dependsOrder": "sequence",
  "group": {
    "kind": "build",
    "isDefault": true
  },
  "problemMatcher": []
}

把这段放入完整的 tasks.json 后，执行链就是 Format → Test。isDefault: true 不会改变任务内容，只是把这个组合任务绑定到当前工作区的默认 build 入口。若两个子任务名称写错，任务选择器里会找不到对应依赖，优先检查 label 的大小写和空格。

运行组合任务并确认顺序

保存文件后，点击 Terminal → Run Task，选择 Format and Test；也可以使用 Terminal → Run Build Task，或按 Ctrl+Shift+B（macOS 为 Cmd+Shift+B）。底部集成终端应先出现格式化脚本的结束信息，随后才出现测试命令的输出。

验收时看三处：任务选择器是否选中组合任务，终端中的两个阶段是否按顺序结束，以及 Problems 面板是否出现新的诊断。如果格式化命令返回非零状态，不要只重跑测试；先处理格式化失败，再重新执行整条组合任务，避免测试通过却留下未整理的代码。

字段怎么选，常见坑在哪里

如果希望两个互不依赖的构建任务同时跑，可以省略 dependsOrder；但格式化和测试存在先后关系时，不要依赖默认行为。Windows 项目还可以为任务提供 windows.command，把 shell 命令换成对应脚本，避免路径和命令解释器差异。

常见问题

为什么 Run Task 里只有 Format，没有 Format and Test？

通常是组合任务没有放进 tasks 数组，或 JSONC 的逗号、括号导致文件解析不完整。先让 IntelliSense 恢复，再确认组合任务有独立的 label。

为什么测试和格式化同时开始？

dependsOn 多项依赖默认可能并行。把 dependsOrder 写成 sequence，并按需要的顺序排列数组。

设置默认任务后快捷键仍然没有反应怎么办？

确认当前打开的是工作区文件夹而不是单个文件，并从 Terminal 菜单重新执行 Run Build Task。VS Code 的任务支持依赖工作区上下文。

这样配置后，格式化和测试仍然是两个可独立调用的任务，同时拥有一个可重复执行的统一入口；后续只需维护各自的 npm 脚本，任务编排不用反复修改。