VSCode任务优化：仅在环境变量缺失时保留终端窗口

问题背景 #

我需要创建一个VSCode任务，在打开文件夹时自动运行，用来检查环境变量是否存在：若环境变量存在则不执行任何操作，若不存在则让运行该任务的终端获取焦点以提醒用户。目前的问题是，无论环境变量是否存在，终端窗口都会保持打开状态。如何实现仅在环境变量缺失（错误场景）时才保留终端窗口？

当前.vscode\tasks.json（版本v2.0.0）内容：

{"label": "Check for environment variable","type": "shell","command": "./check_environment_variable.ps1","problemMatcher": [],"runOptions": {"runOn": "folderOpen","presentation": {"close": false}}}

对应的PowerShell脚本：

# $environment_variable = $env:USERNAME   # success
$environment_variable = $env:USERNAMEX   # failure
if ([Environment]::GetEnvironmentVariable($environment_variable, 'User')) {
    Write-Host -ForegroundColor green "Environment variable exists: `\"$environment_variable`\"" 
}else{
    Write-Host -ForegroundColor red "Warning: Environment variable does NOT exist: `\"$environment_variable`\""
    $missing_variables = $true
}

解决方案 #

核心思路是通过脚本退出码标记任务状态，配合VSCode任务的展示规则，实现成功时自动关闭终端，失败时保留并聚焦终端。

1. 修改PowerShell脚本 #

调整脚本的退出状态：环境变量存在时以成功状态（退出码0）结束，缺失时以错误状态（退出码1）结束：

# $environment_variable = $env:USERNAME   # success
$environment_variable = $env:USERNAMEX   # failure
if ([Environment]::GetEnvironmentVariable($environment_variable, 'User')) {
    Write-Host -ForegroundColor green "Environment variable exists: `"$environment_variable`"" 
    exit 0  # 成功退出，触发终端自动关闭
}else{
    Write-Host -ForegroundColor red "Warning: Environment variable does NOT exist: `"$environment_variable`""
    exit 1  # 错误退出，触发终端保留
}

2. 调整tasks.json配置 #

修改presentation字段的规则，设置为仅在任务成功时关闭终端，失败时保留并聚焦：

{
    "label": "Check for environment variable",
    "type": "shell",
    "command": "./check_environment_variable.ps1",
    "problemMatcher": [],
    "runOptions": {
        "runOn": "folderOpen"
    },
    "presentation": {
        "close": "onSuccess",  // 任务成功时自动关闭终端
        "focus": true          // 任务失败时自动聚焦终端，提醒用户
    }
}

原理说明 #

• VSCode任务会根据脚本的退出码判断执行状态：退出码0为成功，非0为失败。
• presentation.close: "onSuccess"配置让VSCode在任务成功时自动关闭终端，失败时保持窗口打开。
• presentation.focus: true确保环境变量缺失时，终端窗口自动获取焦点，直接触达用户提醒。

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