VS Code tasks.json 怎样用 inputs 复用参数

如果你在 VS Code 里维护了多个任务，最容易重复的往往不是命令本身，而是同一个参数：构建模式、目标环境或要处理的文件名。把它们分别写进每个任务，后面改一次就要找很多处。

更合适的做法是：在 tasks.json 的顶层 inputs 中定义一次输入，再在任务的 command 或 args 中用 ${input:id} 引用它。这样多个任务可以共享同一套选择规则。

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

核心关系只有两步：inputs 负责描述“怎么问”，${input:id} 负责把答案放进任务命令。复用的关键不是复制提示文本，而是让多个任务使用同一个 id。

先确认 tasks.json 在哪里

任务配置通常放在当前工作区的 .vscode/tasks.json。在 VS Code 中可以从顶部菜单进入“终端 > 配置任务”，也可以直接在资源管理器里打开已有的 tasks.json。这篇只处理任务输入，不把它和 settings.json 或 launch.json 混在一起。

打开后先看顶层是否有 version 和 tasks。inputs 也是同一层的配置，不要把它嵌套进某一个 task 对象里。

先定义一个可复用的输入

假设构建和测试都要知道当前模式。我们把它命名为 mode，让读者在运行任务时从 debug 和 release 中选择。下面的配置使用 JSONC 写法，因此注释可以留在文件中帮助团队理解。

{
  "version": "2.0.0",
  "tasks": [],
  "inputs": [
    {
      // id 是复用的稳定名字，任务通过它找到这个输入
      "id": "mode",
      // pickString 让运行任务时从固定选项中选择
      "type": "pickString",
      "description": "选择构建模式",
      "options": ["debug", "release"],
      // 默认值减少重复选择，但不会改变可选范围
      "default": "debug"
    }
  ]
}

这里最重要的是 id。它不是显示给读者看的标题，而是任务引用输入时使用的键。description 决定提示语，options 决定可选值，default 只提供一个默认选项。

让多个任务引用同一个 id

定义好输入后，在任务的 args 中写 ${input:mode}。如果命令本身需要参数，也可以把变量放到 command 或支持变量替换的 options 字符串里。

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "构建项目",
      "type": "shell",
      "command": "npm",
      "args": [
        // build 任务把同一个输入传给脚本参数
        "run", "build", "--", "--mode", "${input:mode}"
      ],
      "problemMatcher": []
    },
    {
      "label": "运行测试",
      "type": "shell",
      "command": "npm",
      "args": [
        // test 任务复用完全相同的输入 id
        "run", "test", "--", "--mode", "${input:mode}"
      ],
      "problemMatcher": []
    }
  ],
  "inputs": [
    {
      // 两个任务都从这个定义取得用户选择
      "id": "mode",
      "type": "pickString",
      "description": "选择构建模式",
      "options": ["debug", "release"],
      "default": "debug"
    }
  ]
}

这个配置的复用粒度很明确：构建和测试仍然是两个独立任务，但它们的 mode 来源相同。以后增加“打包项目”任务时，只需继续引用 ${input:mode}，不用再复制一份选项列表。

从运行任务确认参数确实复用

保存文件后，从顶部菜单选择“终端 > 运行任务”，再选择“构建项目”或“运行测试”。如果任务里出现了 ${input:mode}，VS Code 会根据 inputs 中的定义显示选择提示；选择 debug 或 release 后，变量才会被替换到对应的命令参数位置。

检查时重点看三件事：任务列表中能看到正确的任务标签；输入提示使用的是 description；两个任务都提供同一组 options。如果一项不一致，优先回头检查引用的 id 是否拼写完全相同。

三种输入类型怎么选

inputs 不只有下拉选择。按用户需要填写或动态取得值时，可以换输入类型，但引用方式仍然是 ${input:id}。

如果选项集合是固定的，优先用 pickString，因为读者能直接看到允许值；如果输入每次都不同，再考虑 promptString。不要为了“灵活”把本来有限的环境名改成任意文本，否则任务脚本还要额外承担校验。

复用时最容易踩的坑

把 inputs 写进某个 task 里面

inputs 是任务配置的顶层数组。它不是单个任务的私有字段。若缩进层级放错，任务仍可能显示，但输入变量找不到对应定义。

定义了 mode，却引用成 buildMode

id 区分大小写和拼写。定义是 mode 时，引用就必须是 ${input:mode}。提示文字改了不会影响绑定，id 改了却会影响绑定。

试图让一个 input 依赖另一个 input

输入变量不支持嵌套。不要在一个输入的默认值或选项里再期待另一个 ${input:...} 被动态展开。如果参数之间有依赖关系，应把组合逻辑放到脚本或命令中，并让任务只传递最终需要的值。

把变量写在不支持替换的位置

官方变量参考明确列出了支持变量替换的任务字段。遇到变量原样出现在命令中的情况，先检查它是不是放在 command、args 或其他支持替换的字符串里，而不是只看输入定义是否存在。

最后用一张清单确认配置

• inputs 与 tasks 位于同一个顶层配置对象。
• 每个输入有唯一且稳定的 id。
• 任务使用完整的 ${input:id} 语法，并且 id 与定义完全一致。
• 固定选项使用 pickString，临时文本使用 promptString。
• 从“终端 > 运行任务”选择两个任务时，都能看到预期输入提示。

这样配置之后，参数的维护点就从多个任务收回到一个 inputs 定义，任务只负责声明自己要把这个值传到哪里。新增任务时复用 id，后续修改选项也只改一处。

相关问题

inputs 能不能放在 launch.json？

VS Code 的输入变量也可用于调试配置，但本文的复用示例针对 tasks.json。使用时要把定义和引用放在同一类配置上下文里，避免把任务字段直接复制到调试配置。

为什么只改了 description，任务行为没有变化？

description 主要影响提示文字，真正决定绑定的是 id 和任务中的 ${input:id}。修改提示语不会改变传入命令的值。

多个任务一定只会弹一次输入框吗？

不要把“复用同一个 id”理解成所有任务在一次运行中共享一个全局缓存。每次运行任务时，VS Code 会根据任务配置处理输入；本文要解决的是统一定义和统一选项，不是为任务之间增加隐式状态。