如何让VS Code项目任务读取用户自定义输出目录配置？

问题原因 #

VS Code的.vscode/settings.json中的env字段是用于配置VS Code自身进程的环境变量，任务默认不会继承该字段的配置，因此你用${env:dirLoc}读取时会为空。

解决方案 #

方案1：使用VS Code工作区自定义配置项（推荐）

这是官方推荐的项目级自定义配置方式，更规范且易维护：

1. 在.vscode/settings.json中定义专属配置项：

{
  "project-config.outputDir": "C:\\output\\"
}

2. 在.vscode/tasks.json中通过${config:配置项名称}引用：

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "自定义输出任务",
      "type": "shell",
      "command": "你的命令 ${config:project-config.outputDir}",
      "problemMatcher": []
    }
  ]
}

用户可以直接在VS Code的「设置」→「工作区」中找到project-config.outputDir项修改路径，无需手动编辑JSON文件。

方案2：通过tasks.json直接定义环境变量

如果需要用环境变量的形式传递，可在任务内部定义env字段：

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "自定义输出任务",
      "type": "shell",
      "command": "你的命令 ${env:dirLoc}",
      "env": {
        "dirLoc": "C:\\output\\"
      },
      "problemMatcher": []
    }
  ]
}

缺点是用户修改路径需要编辑tasks.json，不如方案1直观。

方案3：使用.env文件管理环境变量

适合习惯用环境变量文件的场景：

1. 在项目根目录创建.env文件（注意加入.gitignore避免提交本地路径）：

dirLoc=C:\\output\\

2. 在tasks.json中通过envFile指定该文件：

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "自定义输出任务",
      "type": "shell",
      "command": "你的命令 ${env:dirLoc}",
      "envFile": "${workspaceFolder}/.env",
      "problemMatcher": []
    }
  ]
}

内容的提问来源于stack exchange，提问作者rread