VS Code tasks.json 怎么把输入参数传给任务

如果你希望同一个 VS Code 任务每次运行时接收不同的名称、环境或目标，就不要为每个值复制一份任务。把输入定义放在 tasks.json 顶层的 inputs 数组里，再在任务的 command、args 或 options 中使用 ${input:变量ID}，运行任务时 VS Code 就会先弹出输入控件。关键是变量 ID 必须一字不差地对应，任务本身只负责消费这个值。

在 tasks.json 里声明输入变量并引用它

先用命令面板执行 Tasks: Configure Task，选择创建或打开工作区的 .vscode/tasks.json。下面这个例子让任务运行时询问构建目标，并把回答作为脚本的一个参数：

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "Show selected task input",
      "type": "shell",
      "command": "node",
      "args": ["scripts/show-task-input.js", "${input:taskName}"],
      "problemMatcher": []
    }
  ],
  "inputs": [
    {
      "id": "taskName",
      "type": "promptString",
      "description": "Task name",
      "default": "build-preview"
    }
  ]
}

这里的 id 是连接声明与任务的键，${input:taskName} 是引用。description 是弹窗提示语，default 只提供预填值，不会改变变量类型。配置保存后，编辑器里的 JSON IntelliSense 还能帮助你发现拼写错误。

运行任务并确认参数已经传入

按 Cmd/Ctrl+Shift+P 打开命令面板，执行 Tasks: Run Task，或者打开顶部菜单“终端 > 运行任务”，再选择 Show selected task input。VS Code 会显示 Task name 输入框，填入例如 build-preview 后确认。

正确的可见状态有两个：输入框关闭后，集成终端中的命令或输出包含 build-preview；任务面板显示任务已经结束。只看到任务启动、没有看到参数，通常是引用写在了不支持变量替换的字段，或者脚本实际读取的参数位置不对。

自由文本、固定选项和命令输入怎么选

需要用户临时输入分支名、目标名时，用 promptString；值只能从几项配置中选择时，用 pickString：

{
  "id": "buildMode",
  "type": "pickString",
  "description": "Build mode",
  "options": ["debug", "release"],
  "default": "debug"
}

任务里仍然使用 ${input:buildMode}。如果输入来自扩展提供的命令，则把类型设为 command 并填写扩展命令 ID；这类输入的参数由该命令决定，不能只靠 tasks.json 猜测返回格式。官方文档目前列出这三种输入变量类型。

传多个参数时，优先把每个参数拆成 args 数组的独立元素。这样输入中即使有空格，也不会因为 shell 的拆词规则把一个值误拆成两个参数；如果使用 shell 任务，仍要遵守当前系统 shell 的引号规则。

不弹窗或参数为空时怎么排查

还可以临时添加一个只负责输出 ${workspaceFolder} 或输入值的任务，借集成终端确认 VS Code 实际解析到的内容。确认变量本身有值后，再恢复真正的构建或测试命令，排查会更快。

常见问题

inputs 应该放在 tasks.json 的哪里？

放在配置顶层，与 version、tasks 同级。任务对象中只写引用，例如 ${input:taskName}，不要把完整输入对象塞进某个 task。

所有 tasks.json 字段都能使用输入变量吗？

不能。官方变量参考明确列出主要支持 command、args 和 options 等字符串位置；遇到不生效的字段，先把变量移动到 args 验证。

把输入声明、引用位置和运行后的终端结果连起来检查，通常就能定位 tasks.json 传参问题。配置规模变大后，给每个输入使用描述清楚、稳定的 ID，也比复制多份任务更容易维护。