VS Code 任务怎样传递工作区变量

VS Code 任务可以把 ${workspaceFolder} 写进 args、options.cwd 或 options.env：分别作为命令参数、工作目录和子进程环境变量。变量由 VS Code 在启动任务前替换，接收程序再按自己的参数或环境接口读取。不要把这三种传递方式混为一谈。

官方地址：https://code.visualstudio.com/。下面以桌面版 VS Code 和已安装 Node.js 的可信测试文件夹为例，只输出路径，不构建、不发布、不读取业务文件。界面配图均为 ImageGen 原创说明图，不是软件截图；本文没有启动 VS Code 或执行示例。

1. 打开演示文件夹并准备接收脚本

在 VS Code 中选择 File → Open Folder，打开一个专用演示目录，例如名为 task-demo 的文件夹。只在确认目录内容可信后处理工作区信任提示，不要为了运行任务而信任陌生项目。不要只打开一个孤立文件，否则示例需要的文件夹上下文不完整。

在左侧 Explorer 中使用新建文件入口，创建 show-context.cjs，填入以下内容并保存。它接收一个路径参数，另外读取自己的工作目录和一个专用环境变量。这里使用不与系统变量重名的 TASK_DEMO_ROOT。

// 只显示任务传入的上下文，不扫描目录或修改文件
const argumentRoot = process.argv[2];
const environmentRoot = process.env.TASK_DEMO_ROOT;

if (!argumentRoot || !environmentRoot) {
  // 缺少传参时明确失败，避免空值被误判为正确路径
  console.error("缺少工作区参数或TASK_DEMO_ROOT");
  process.exitCode = 1;
} else {
  console.log("参数路径:", argumentRoot);
  console.log("工作目录:", process.cwd());
  console.log("环境路径:", environmentRoot);
}

完成状态：资源管理器根节点显示演示文件夹，下面能看到 show-context.cjs，编辑器标签没有未保存标记。这时脚本只是准备好了，还未运行。

2. 在tasks.json中映射变量与执行目标

选择 Terminal → Configure Tasks。在尚无任务配置的演示目录中，选择 Create tasks.json file from template → Others，生成 .vscode/tasks.json。如果文件已经存在，保留原任务，在原有 tasks 数组中增加本例对象，不要整份覆盖项目配置。菜单语言可能不同，括号内英文名称便于对照。

下面给出独立演示文件夹的完整配置。VS Code 的任务文件支持 JSON with Comments，因此块内的中文注释可以保留；不要把带注释的文件拿去当严格 JSON 处理。

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "显示工作区上下文",
      // 直接启动进程，避免把路径拼成一整条shell命令
      "type": "process",
      "command": "node",
      "args": [
        "${workspaceFolder}${pathSeparator}show-context.cjs",
        "${workspaceFolder}"
      ],
      "options": {
        // cwd决定相对路径的解释位置，不是新增一个命令参数
        "cwd": "${workspaceFolder}",
        "env": {
          // 子进程通过process.env读取此值
          "TASK_DEMO_ROOT": "${workspaceFolder}"
        }
      },
      "problemMatcher": [],
      "presentation": {
        "reveal": "always",
        "panel": "dedicated"
      }
    }
  ]
}

command: node 要求任务所在环境能找到 Node.js；VS Code 本身的可执行文件路径不是 Node.js 命令的替代品。若找不到 node，先处理该环境的安装与 PATH，再重试本任务，不要把工作区路径误填为执行程序。

这里的 args 第一个元素是脚本路径，第二个元素才是给脚本的业务参数。路径作为独立数组元素传递，并采用 process 类型，不要额外把引号字符包进路径值。若改成 shell 任务，则还需遵守所用 shell 的转义规则。

完成状态：编辑器打开 .vscode/tasks.json，能看到任务标签“显示工作区上下文”及三处工作区变量，保存后没有语法错误标记。label 是固定显示名称，不依赖变量替换。

3. 运行任务并核对接收值

保存配置后，选择 Terminal → Run Task，在任务列表中选择 显示工作区上下文。任务输出面板应被展开；本例设置了空 problemMatcher，若出现额外的问题匹配器选择提示，确认运行的是本例手工任务而不是自动发现的其他任务。

预期终端显示“参数路径”“工作目录”“环境路径”三项，均指向当前演示根目录。这是读者执行时的成功条件，不是本文已取得的日志。路径拼写可能因平台或符号链接表现不同，不要只凭斜杠方向判定错误；重点是是否定位同一个预期目录。

如果脚本报告缺少环境变量，检查 options.env 的拼写和所运行任务；如果提示找不到脚本，检查脚本是否保存在该根目录、路径分隔符及 args 首项；如果列表没有此任务，先确认文件名和保存位置，再重新进入 Run Task。

核对完成后，本例不需要导出或下载文件：任务已经把工作区上下文交给外部程序。需要迁移到另一个测试项目时，带上脚本和对应任务对象即可，前提是新环境同样具备 Node.js；不要复制本机绝对路径或凭据。

多根工作区怎样指定另一个根目录？

无名称的工作区变量以配置所属文件夹为上下文。若工作区有名为 Client 的根目录，可用 ${workspaceFolder:Client} 明确引用它。应先在 Explorer 核对根名称；若改了脚本目标，也要同步确认脚本实际位于哪个根目录，不能只改 cwd。

能在args中读取刚写入options.env的值吗？

不要把 ${env:TASK_DEMO_ROOT} 当作对同一任务 options.env 的后续读取。options.env 设置的是待启动子进程的环境，不会成为其他任务字段的变量依赖来源。本例直接在 args 中使用工作区变量，环境值则留给脚本读取。

为什么换了活动文件，执行目标也变了？

${file} 与活动编辑器文件相关；它不等于工作区根目录。需要固定项目根目录时用工作区变量，不要用当前文件变量替代。只有确实要处理当前文件时，才把它放到明确的参数位置。

参考 VS Code 官方变量说明：https://code.visualstudio.com/docs/reference/variables-reference；任务配置与运行入口：https://code.visualstudio.com/docs/debugtest/tasks。