VS Code tasks为任务配置可复用输入变量的实现方法

VS Code tasks 适合把构建、测试或启动命令固定下来，但环境名、服务名这类参数不应该每次都硬编码。做法是把参数声明在工作区的 .vscode/tasks.json 的 inputs 中，再在任务的 args 里用 ${input:id} 引用。运行任务时，VS Code 会先弹出选择或输入面板，确认后再替换参数。

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

步骤一：从工作区任务入口创建 tasks.json

先用文件夹打开项目，不能只打开一个孤立文件。点击顶部菜单 Terminal → Configure Tasks...，在任务模板列表选择 Create tasks.json file from template，随后选择 Others。如果项目已经有该文件，VS Code 会直接打开它，不要重复创建第二份。

看到编辑器中的 .vscode/tasks.json，并且文件已有 version 与 tasks 节点，就可以进入参数配置。这里的界面图是原创操作示意，不是实际软件截图。

步骤二：在 inputs 中声明可复用参数

把下面配置放进 tasks.json。示例用一个下拉选择环境、一个文本输入服务名，真正执行的命令仍然只是示例；你可以把 npm run dev 换成项目自己的启动脚本。

{
  // tasks.json 使用 JSONC，可在关键配置旁写中文说明。
  "version": "2.0.0",
  "inputs": [
    {
      // pickString 适合环境、地区等有限选项。
      "id": "envName",
      "type": "pickString",
      "description": "选择运行环境",
      "options": ["dev", "staging"],
      "default": "dev"
    },
    {
      // promptString 适合每次可能变化的服务名。
      "id": "serviceName",
      "type": "promptString",
      "description": "输入服务名",
      "default": "api"
    }
  ],
  "tasks": [
    {
      "label": "启动服务",
      "type": "shell",
      // args 中引用 input，避免把用户输入拼进 command 字符串。
      "command": "npm",
      "args": [
        "run", "dev", "--",
        "--env", "${input:envName}",
        "--service", "${input:serviceName}"
      ],
      "problemMatcher": []
    }
  ]
}

关键是三个名字必须一致：输入项的 id、引用里的名称和任务实际需要的参数。VS Code 官方说明中，变量替换并不是所有属性都支持；本例把变量放在 args，属于适合的位置。保存后，如果补全能识别 input 引用，就说明结构基本正确。

步骤三：通过 Run Task 触发输入面板

点击 Terminal → Run Task...，选择 启动服务。先在 选择运行环境 面板中选 staging，再在 输入服务名 框中填入 orders 并确认。若任务没有出现在列表，先保存文件，再确认当前窗口打开的是包含 .vscode 的工作区。

成功状态不是“弹窗消失”，而是终端实际收到正确参数，例如回显 env=staging service=orders。如果终端仍出现字面量 ${input:envName}，优先检查引用拼写、JSONC 逗号和任务是否从当前工作区加载。

步骤四：用重运行和边界检查复用参数

任务执行后可用命令面板运行 Tasks: Rerun Last Task。默认情况下，重运行会重新求值输入变量，适合切换环境；如果希望重运行固定上一轮解析出的值，可在任务中加入：

// 关闭重运行时的重新求值，让本轮解析出的参数保持不变。
{
  "runOptions": {
    "reevaluateOnRerun": false
  }
}

排查时按这张清单核对：inputs.id 是否唯一，引用是否写成 ${input:id}，带空格的服务名是否作为独立的 args 元素传递，以及任务是否确实属于当前工作区。不要把密码、Token 等敏感值放进任务输入或终端回显。

常见问题

为什么 tasks.json 中写了 inputs 却没有弹窗？

只有任务真正引用了 ${input:id} 时，运行它才会请求对应输入；只声明不用，不会自动弹出。

可以把输入变量直接写进 command 吗？

可以，但参数多或包含空格时更容易遇到 shell 转义问题。优先把命令和每个参数拆到 args，更容易检查。

重运行为什么没有重新询问？

检查任务是否设置了 reevaluateOnRerun: false；该设置会让 VS Code 复用上一轮解析结果。

完成以上四步后，同一个 VS Code task 就能在固定执行逻辑之外复用不同环境和服务参数。后续只需维护 inputs 的选项与任务的 args 映射，避免反复编辑命令本身。