VS Code 多根工作区怎么为不同文件夹配置任务

在 VS Code 多根工作区里，最稳妥的做法是把“只属于某个文件夹”的任务放进该文件夹的 .vscode/tasks.json，把需要一次协调多个根目录的任务放进 .code-workspace。这样任务的工作目录、脚本和显示名称都有明确归属，不会因为当前打开的文件不同而跑错项目。

官方地址：https://code.visualstudio.com/docs/editing/workspaces/multi-root-workspaces

下面用 frontend 和 api 两个根目录说明完整路径。文中的界面图片都是原创操作说明图，不是 VS Code 截图或运行证据。

先把两个项目放进同一个多根工作区

选择“文件 → 将文件夹添加到工作区”，先打开第一个项目，再重复一次把第二个项目加入。也可以使用“文件 → 将工作区另存为”，保存成一个 team.code-workspace 文件。资源管理器里应该能看到两个并列的根目录，而不是一个目录下的两个普通子文件夹。

保存工作区文件后，团队成员打开同一个 .code-workspace 文件即可得到相同的根目录组合。若某个目录没有显示在资源管理器顶层，先不要写任务配置，避免把相对路径误认为工作区根目录。

给每个文件夹配置自己的 tasks.json

在 frontend/.vscode/tasks.json 中配置前端任务，在 api/.vscode/tasks.json 中配置接口任务。打开“终端 → 配置任务”，也可以直接新建这两个文件。关键是每个任务的 options.cwd 指向该根目录，任务标签再带上项目名，选择时更容易辨认。

例如前端任务可以写成下面这样。version 必须是 2.0.0；label 是任务选择器里的名称；command 是要执行的命令；cwd 让命令不依赖当前编辑器文件。

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "frontend: 开发构建",
      "type": "shell",
      "command": "npm run build",
      "options": {
        "cwd": "${workspaceFolder}"
      },
      "problemMatcher": []
    }
  ]
}

把相同结构放入 api/.vscode/tasks.json 时，将标签改为 api: 启动检查，命令换成接口项目实际使用的启动或测试命令。不要把两个项目的命令都写进一个 folder-scoped 文件，否则任务归属会变得模糊。

需要统一触发时再使用工作区级任务

如果目标是点击一次就依次处理两个项目，可以在命令面板执行“工作区: 打开工作区配置文件”，在 team.code-workspace 中增加 tasks。多根工作区的根目录引用使用命名变量，例如 ${workspaceFolder:frontend} 和 ${workspaceFolder:api}。工作区配置里的任务类型只使用 shell 或 process，更复杂的项目任务仍放回各自的 .vscode/tasks.json。

{
  "folders": [
    { "path": "frontend", "name": "frontend" },
    { "path": "api", "name": "api" }
  ],
  "tasks": {
    "version": "2.0.0",
    "tasks": [
      {
        "label": "team: 先构建前端",
        "type": "process",
        "command": "npm",
        "args": ["run", "build"],
        "options": { "cwd": "${workspaceFolder:frontend}" },
        "problemMatcher": []
      }
    ]
  }
}

这里的 JSON 字段保持严格有效，字段含义已在代码块后解释。统一任务适合串起明确的共享动作；不要为了省文件，把所有项目的独立任务都塞进工作区级配置。

按可见状态确认任务没有跑错目录

1. 选择“终端 → 运行任务”，先观察任务列表中的 frontend:、api: 和 team: 前缀。
2. 运行一个文件夹任务，查看终端标签和输出内容，确认脚本读取的是该根目录下的配置。
3. 如果任务需要停止，选择“终端 → 终止任务”，不要直接关闭整个窗口，以免把另一个根目录的任务一起中断。
4. 关闭工作区后重新打开 team.code-workspace，再次从任务选择器运行，确认配置不是临时工作区状态。

常见的“任务找不到”通常是 tasks.json 放错了层级、版本不是 2.0.0，或任务标签相同导致选择困难。常见的“命令在错误目录执行”则优先检查 options.cwd 和根目录名称，尤其是文件夹被重命名后，变量名必须和工作区配置中的 name 一致。

最后的配置清单

相关问题

为什么不把所有任务写在一个文件里？ 因为文件夹级任务更贴近项目本身，迁移或单独打开项目时仍然可用；工作区级任务只保留跨项目的协调动作。

`${workspaceFolder}` 和 `${workspaceFolder:frontend}` 有什么区别？ 前者表示当前任务所属的工作区文件夹，后者按名称明确指定多根工作区中的某个根目录，跨根目录配置时后者更不容易产生歧义。