VS Code Tasks 怎样复用输入变量

在 VS Code Tasks 中复用输入变量，做法是把输入声明在 inputs 数组里，再用 ${input:变量ID} 放进任务的 command 或 args。同一个变量 ID 可以在多个参数位置出现；运行任务时 VS Code 先询问一次，再把同一个值展开到这些位置。

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

本文只讨论 .vscode/tasks.json 中的输入变量复用，不把它扩展成扩展开发或调试配置教程。最后的核对重点是：输入是否只出现一次、多个参数是否得到同值、集成终端是否能看出实际展开结果。

先看最终效果：一个输入值服务多个参数

假设任务需要同时接收运行环境和输出目录。可以声明一个 profile 输入，让任务把它分别传给两个参数。这样每次运行只选择一次 dev 或 prod，不会为同一个环境重复弹窗。

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "显示任务参数",
      "type": "shell",
      "command": "node",
      "args": [
        "scripts/show-config.js",
        "--profile", "${input:profile}",
        "--output", "dist/${input:profile}"
      ],
      "problemMatcher": []
    }
  ],
  "inputs": [
    {
      "id": "profile",
      "type": "pickString",
      "description": "选择环境",
      "options": ["dev", "prod"],
      "default": "dev"
    }
  ]
}

这里的复用键只有 profile。它在 args 中出现两次，但定义只出现一次。读者真正要验收的不是配置看起来完整，而是选择 dev 后，两个参数都使用 dev。

先把输入变量放进任务配置

第一步是在工作区打开 .vscode/tasks.json。如果还没有这个文件，可以从菜单 Terminal > Configure Tasks 创建一个任务配置。任务支持工作区目录；只打开单个文件时，不会得到完整的工作区任务入口。

第二步给输入项设置稳定的 id。id 是配置内部的引用名，不是显示给用户的标题；用户看到的提示文字来自 description，候选项来自 options。

输入类型按任务需要选择：

用同一个 ID 复用，而不是复制一份声明

在任务的 command、args 或 options 中写 ${input:profile}，就能引用前面声明的输入。复用时只复制这个引用表达式，不复制整个输入对象，否则两个提示可能出现默认值或选项不一致。

{
  "label": "构建当前环境",
  "type": "shell",
  "command": "npm",
  "args": [
    "run", "build",
    "--",
    "--mode", "${input:profile}",
    "--report", "reports/${input:profile}.json"
  ]
}

这个片段说明了参数形态：同一个输入既作为普通参数值出现，也参与了路径字符串。它不会让 inputs 里的字段再次解析另一个输入变量，因为 VS Code 不支持输入变量嵌套。配置字段也不是任意位置都支持替换，官方文档明确将重点范围放在 command、args 和 options。

运行一次，核对输入是否真的复用

1. 从菜单选择 Terminal > Run Task，再选择“显示任务参数”。
2. 在“选择环境”提示中选择 dev，不要为两个参数分别输入。
3. 观察集成终端：两个引用位置都应展开为 dev，输出目录应变成 dist/dev。
4. 看到任务完成状态后，再检查是否存在参数拼写、路径引号或脚本自身错误。

如果输出里出现 profile=dev 和 mode=dev，说明复用关系符合预期。图示中的文字只用于解释界面状态；实际终端输出仍以你的脚本和操作系统 shell 为准。

异常时按三个位置修正

• 没有弹窗：先检查任务是否真的写了 ${input:profile}，以及任务是否从工作区运行。
• 提示变量不存在：检查引用中的 ID 是否与 inputs 里的 id 完全一致，大小写也不要混用。
• 只替换了一处：检查另一个参数是否仍写成了固定字符串；复用必须再次写引用表达式。
• 输入后命令失败：先在终端查看实际参数，再判断是任务展开问题，还是脚本、路径和 shell 引号问题。

不要把输入变量写成全局变量来理解：它只是当前任务配置中的引用。也不要把一个 ${input:...} 再嵌进另一个输入定义里；需要组合值时，应在任务参数或脚本层明确组合规则。

相关问题

同一个输入变量能在多个任务里复用吗？ 可以在同一份任务配置中引用相同的输入定义，但每个任务仍要明确写出引用位置。

想让用户自由输入路径用什么类型？ 通常使用 promptString；如果值只能从固定集合中选择，使用 pickString 更容易避免拼写差异。

为什么把输入变量写进 inputs 的 default 没有继续展开？ 因为输入变量不支持嵌套。把默认值直接写成最终文本，或把组合逻辑移到任务命令和脚本中。

归档这份配置时，建议保留输入 ID 的命名规则，并在任务输出中留下能识别实际参数的简短信息。这样下次出现“任务运行了但环境不对”时，可以先从一次运行结果判断变量是否正确展开，再进入脚本内部排查。

参考：https://code.visualstudio.com/docs/reference/variables-reference、https://code.visualstudio.com/docs/debugtest/tasks。