如何在VS Code任务的PowerShell Here-String中保留双引号

问题描述 #

在VS Code中配置PowerShell任务时，使用Here-String无法保留双引号，且必须使用${selectedText}变量（无法修改该变量内的引号格式）。

复现步骤 #

• 将对应任务配置添加到tasks.json
• 运行该任务
• 预期输出为abcd \"abcd\"，但任务终端实际输出abcd abcd

任务配置 #

固定文本任务： #

{
  "label": "Run test powershell here-string",
  "type": "shell",
  "windows": {
    "options": {
      "shell": {
        "executable": "powershell.exe",
        "args": ["-NoLogo", "-Command"]
      }
    },
    "command": "$stext=\n@'\nabcd \"abcd\"\n'@\n ; echo $stext "
  },
  "options": {
    "cwd": "${workspaceFolder}"
  },
  "problemMatcher": []
}

含${selectedText}的任务（选中文本含双引号时）： #

{
  "label": "Run test powershell here-string",
  "type": "shell",
  "windows": {
    "options": {
      "shell": {
        "executable": "powershell.exe",
        "args": ["-NoLogo", "-Command"]
      }
    },
    "command": "$stext=\n@'\n${selectedText}\n'@\n ; echo $stext "
  },
  "options": {
    "cwd": "${workspaceFolder}"
  },
  "problemMatcher": []
}

实际输出 #

*  Executing task: $stext=
                           @'
                             abcd \"abcd\"\n                                        '@
                                           ; echo $stext  

abcd abcd
 *  Terminal will be reused by tasks, press any key to close it. 

解决方法 #

方法1：改用双引号Here-String并修正转义逻辑 #

单引号Here-String（@'...'@）会忽略内部转义字符，但VS Code在解析JSON配置时会提前处理\"为普通双引号，导致PowerShell无法识别转义。改用双引号Here-String并在JSON中做双重转义：

修改固定文本任务的command字段：

"command": "$stext = @\"`nabcd \\\"abcd\\\"`n\"@ ; Write-Output $stext"

• JSON中用\\\"表示PowerShell中的\"（JSON转义一次为\"，PowerShell再转义一次为\+"）
• 用PowerShell的换行符`n替代JSON的\n，避免解析冲突

方法2：适配${selectedText}的通用方案 #

针对含${selectedText}的场景，用脚本块包裹命令并处理双引号转义，确保选中文本中的引号被保留或转义：

修改任务的command字段：

"command": "& { $stext = @\"`n${selectedText}`n\"@ -replace '\"', '\\\"' ; Write-Output $stext }"

• & { ... }确保PowerShell正确解析完整脚本逻辑
• 双引号Here-String（@"..."@）保留${selectedText}的原始内容
• -replace '\"', '\\\"'将文本中的双引号替换为转义格式，满足预期输出要求

方法3：Base64编码传递命令（最可靠） #

如果转义逻辑过于复杂，可将PowerShell命令转为UTF-16LE编码的Base64字符串，通过-EncodedCommand参数传递，彻底避免转义冲突：

示例配置（对应命令：获取选中文本并输出带转义的双引号）：

{
  "label": "Run test powershell here-string",
  "type": "shell",
  "windows": {
    "options": {
      "shell": {
        "executable": "powershell.exe",
        "args": [
          "-NoLogo",
          "-EncodedCommand",
          "JABzAHQAZQB4AHQAPQAgACQAZABhAHQAYQAgAC0AZQB4AHAAZQByAGMAaQB0ACAATgBlAHcALQBTAGUAdAB0AGkAbwBuACAALQBmAG8AcgBjAGUAIABbAGMAbwBtAHAAbwBuAGUAdAB0AC0AbgBlAHcALQB0AG8AbwBsAGwAXQA7ACAAJABzAHQAZQB4AHQAPQAgACQAcwB0AGUAeAB0ACAALQByAGUAcABsAGEAYwBlACAAJwAiACcAIAAkACcAXwAiACcAOwAgAGUAYwBoAG8AIAAkAHMAdABlAHgAdAA="
        ]
      }
    }
  },
  "options": {
    "cwd": "${workspaceFolder}"
  },
  "problemMatcher": []
}

你可以自己生成对应命令的Base64编码：将PowerShell命令保存为UTF-16LE编码的文本，再转为Base64即可。

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