VS Code Tasks 怎样让多根工作区命令指向指定文件夹

在 VS Code 多根工作区里，任务不应该依赖当前打开的是哪个文件夹。要让命令稳定指向指定根目录，可以在 tasks.json 中使用带根文件夹名的变量，例如 ${workspaceFolder:api}。它会把路径解析到名为 api 的工作区根文件夹，适合放在 options.cwd 或命令参数里。

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

第 1 步：确认多根工作区和任务入口

在 VS Code 左侧打开 Explorer，确认工作区下至少有两个根文件夹，例如 api 和 web。多根工作区中的根文件夹名称就是变量里的作用域名称；它不一定等于磁盘上的完整路径。

接着依次选择 Terminal > Configure Tasks...，或直接打开已有的 .vscode/tasks.json。如果每个根目录分别维护自己的任务配置，先确认当前打开的配置文件属于哪个根目录；本文示例使用工作区级任务文件，把目标目录显式写成 api。

第 2 步：在 tasks.json 中指定目标根文件夹

在任务对象中，把 options.cwd 设置为 ${workspaceFolder:api}。这样任务启动时的工作目录固定为 api 根目录，即使你当前正在编辑 web 里的文件，也不会改变任务目标。

下面是一个严格 JSON 示例，JSON 本身不支持注释，所以关键字段放在代码块前后解释。label 是任务列表显示名，command 是实际命令，options.cwd 是该任务启动时的工作目录。

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "Build API",
      "type": "shell",
      "command": "npm",
      "args": ["run", "build"],
      "options": {
        "cwd": "${workspaceFolder:api}"
      },
      "group": "build",
      "problemMatcher": []
    }
  ]
}

如果项目命令要求路径参数，也可以把同一个变量放进 args，例如 "--prefix", "${workspaceFolder:api}"。不要把 ${workspaceFolder:api} 填到不支持变量替换的任意字段；VS Code 官方说明，任务配置中主要支持替换的位置包括 command、args 和 options。

第 3 步：从 Run Task 运行并核对目标

保存文件后选择 Terminal > Run Task...，再选择 Build API。如果任务名称太多，可以先在任务列表中按标签搜索。运行前检查任务配置是否仍显示 workspaceFolder:api，不要把同名的 Build Web 选错。

对于需要确认路径的项目，可以临时把命令替换为项目允许的路径打印命令，或让构建工具输出当前工作目录。这里的核对目标是任务配置的解析结果，不是把某张界面图当成真实执行证据。任务结束后，检查构建产物是否落在 api 项目预期位置，并将临时诊断改回正式命令。

第 4 步：排查变量看似不生效的情况

如果任务仍然跑到了错误目录，按下面顺序检查：

• 根文件夹名称：${workspaceFolder:api} 中的 api 必须与 Explorer 里的根名称一致，大小写和空格也要一致。
• 字段位置：确认变量放在 command、args 或 options 等支持替换的字段中，而不是任意自定义字段。
• 变量含义：${workspaceFolder} 表示当前任务所属的工作区文件夹；${workspaceFolder:api} 才是多根工作区中指定名称的根文件夹；${workspaceFolderBasename} 只返回名称，不是完整路径。
• 任务来源：确认运行的是刚保存的任务配置，而不是扩展自动发现的同名任务或另一个根目录下的 tasks.json。

需要使用环境变量时，应使用 ${env:NAME}；它解决的是进程环境值，不等于把任务工作目录切换到某个工作区根。多根任务的核心是明确写出目标根名称，而不是依赖当前编辑器焦点。

常见问题

${workspaceFolder:api} 找不到文件夹怎么办？

先确认当前窗口打开的是多根工作区，并检查 Explorer 中的根名称是否真的叫 api。如果名称不同，应改成实际根名称；不要用猜测的绝对路径替代变量。

应该把变量放在 cwd 还是 args？

需要改变命令执行目录时放在 options.cwd；需要把目标目录作为工具参数传入时放在 args。两者可以同时使用，但应确认工具对参数路径和当前工作目录的含义不同。

单根工作区也能使用带名称的写法吗？

单根工作区更直接的写法是 ${workspaceFolder}。带名称的形式主要解决多根工作区需要明确选择某个根文件夹的场景。

最终可以用“确认根名称 → 固定 cwd 或参数 → 从 Run Task 选择正确标签 → 核对任务输出位置”的顺序维护多根任务。这样即使编辑器当前焦点切换到另一个项目，任务也会继续指向明确的目标根目录。