VS Code执行tasks.json中PowerShell脚本时出现Command参数错误

问题场景 #

使用VS Code的tasks.json配置调用PowerShell脚本时，执行任务后出现参数错误，相关配置及错误信息如下：

tasks.json配置 #

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Hello, World",
            "type": "shell",
            "command": "${workspaceFolder}/scripts/hello_world.ps1"
        }
    ]
}

调用的PowerShell脚本（hello_world.ps1） #

Write-Host "Hello, World"

错误输出 #

Set-Location : 找不到与参数名称“Command”对应的参数。
行:1 字符:62

• ... tion 'D:\work\GIT\joint-observation-complex.vscode' -Command D:\work ...

• ~~~~~~~~
  

  • CategoryInfo : InvalidArgument: (:) [Set-Location], ParameterBindingException
  • FullyQualifiedErrorId : NamedParameterNotFound,Microsoft.PowerShell.Commands.SetLocationCommand

错误原因 #

VS Code执行shell类型任务时，会自动生成切换工作目录的命令，再拼接要执行的脚本命令。但此处出现参数拼接错误：系统错误地将-Command参数传递给了Set-Location命令，而Set-Location并不支持-Command参数，从而触发语法报错。

核心问题是默认的shell任务逻辑与PowerShell的命令调用格式不兼容，导致命令拼接异常。

解决方法 #

提供三种可行的修复方案：

方案一：切换任务类型为process #

将任务类型从shell改为process，直接调用PowerShell进程执行脚本，绕开shell的目录切换逻辑：

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Hello, World",
            "type": "process",
            "command": "powershell.exe",
            "args": [
                "-File",
                "${workspaceFolder}/scripts/hello_world.ps1"
            ]
        }
    ]
}

方案二：明确指定PowerShell调用格式（保留shell类型） #

如果需要保留shell类型任务，需完整指定PowerShell的调用命令，避免参数混淆：

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Hello, World",
            "type": "shell",
            "command": "powershell.exe -File '${workspaceFolder}/scripts/hello_world.ps1'"
        }
    ]
}

方案三：明确指定工作目录（保留shell类型） #

通过options.cwd字段手动指定工作目录，避免VS Code自动生成错误的目录切换命令：

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Hello, World",
            "type": "shell",
            "command": "${workspaceFolder}/scripts/hello_world.ps1",
            "options": {
                "cwd": "${workspaceFolder}"
            }
        }
    ]
}

内容的提问来源于stack exchange，提问作者Александр Очеретько