VS Code 多根工作区任务怎么配置或排查

当一个仓库同时放着 web 和 api 两个目录时，VS Code 最容易出现的任务问题不是命令写错，而是工作区没有保存、任务挂在错误的根目录，或者复合任务没有明确执行顺序。本文把这条链路一次配好，并给出从界面状态到终端反馈的排查方法。

官方地址：https://code.visualstudio.com/docs/

先把多根工作区保存成可共享文件

先不要直接编辑某个目录下的 .vscode/tasks.json。在 VS Code 顶部菜单选择 File > Add Folder to Workspace，依次加入 web 与 api。如果 Explorer 左侧只显示一个根目录，说明当前仍是单目录模式。

1. 确认 Explorer 中出现两个根目录，并在根目录名称上右键检查菜单中有 Remove Folder from Workspace。
2. 选择 File > Save Workspace As...，保存为 team.code-workspace。共享给同事时尽量使用相对路径，避免把本机绝对路径带进配置。
3. 重新打开时使用 File > Open Workspace，选中这个 .code-workspace 文件，而不是只打开 web 文件夹。

把任务绑定到正确的根目录

按 Command Palette（⇧⌘P）并执行 Workspaces: Open Workspace Configuration File，在打开的工作区文件中加入任务。下面的 JSONC 示例故意把两个构建命令拆开，让排查时能立刻看出是哪一个目录失败。

{
  "folders": [
    { "name": "web", "path": "web" },
    { "name": "api", "path": "api" }
  ],
  "tasks": [
    {
      "label": "Build web",
      "type": "shell",
      "command": "npm run build",
      "options": {
        // 中文说明：让前端命令始终在 web 根目录执行。
        "cwd": "${workspaceFolder:web}"
      }
    },
    {
      "label": "Build api",
      "type": "shell",
      "command": "npm run build",
      "options": {
        // 中文说明：后端任务使用 api 根目录，避免误用当前编辑器目录。
        "cwd": "${workspaceFolder:api}"
      }
    },
    {
      "label": "Build all",
      "dependsOn": ["Build web", "Build api"],
      // 中文说明：明确先后；删除这一行时，多项依赖默认可并行执行。
      "dependsOrder": "sequence"
    }
  ]
}

这是 JSONC 配置，所以示例里的中文注释可以保留；如果你把内容放进严格 JSON 工具中再处理，需要删除注释。任务的 label 是界面和依赖引用的唯一名字，改了子任务名称后要同步修改 dependsOn。

运行任务并按证据排查

保存文件后选择 Terminal > Run Task，应该能看到 Build web、Build api 和 Build all。优先运行 Build all，再看集成终端里每条命令前的工作目录和返回结果。下面的输出只表示期望的界面反馈，不是本机执行截图。

# 中文说明：从任务菜单触发工作区级复合任务。
Build all

# 中文说明：先核对前端，再核对接口目录的结果。
web build succeeded
api build succeeded

如果列表里没有 Build all，先检查是否重新打开了 .code-workspace；只打开单个文件或单个文件夹时，工作区级任务不会出现。如果任务出现但命令在错误目录执行，检查 options.cwd 的根目录名称是否与 folders[].name 完全一致。

如果两个任务同时跑并不符合依赖关系，不要只凭终端顺序猜测：VS Code 的多个 dependsOn 默认可并行，必须显式加入 "dependsOrder": "sequence"。如果任务执行后终端不自动展开，可给任务加上下面的显示配置：

"presentation": {
  // 中文说明：失败时保留终端并让问题更容易被看到。
  "reveal": "always",
  "panel": "dedicated"
}

最后确认配置是否真的可交接

把 team.code-workspace 提交到项目后，用一次干净的 VS Code 窗口重新打开它，完成以下检查：Explorer 是否有两个根目录；Terminal > Run Task 是否能找到 Build all；两个子任务是否分别进入 web 和 api；失败时是否能在终端或 Problems 面板看到第一条具体错误。四项都满足，说明任务配置已经从“只在本机能点”变成了可共享的工作区配置。

相关问题

多根工作区一定要把任务都写进 .code-workspace 吗？ 不一定。目录专属任务可以继续写在该根目录的 .vscode/tasks.json；只有需要跨目录组合或共享的任务，才适合放进工作区文件。

为什么任务能显示却执行失败？ 先区分“任务被找到”和“命令能运行”两个层次。标签正确只说明配置被加载，依赖是否安装、脚本是否存在、cwd 是否指向含有 package.json 的目录，仍要从终端的第一条错误分别确认。