调试Azure Function时VSCode为何调用wsl.exe？如何解决？

问题描述 #

我正在按照微软Azure Functions教程《快速入门：使用Visual Studio Code和Python在Azure中创建函数》操作，在「本地运行函数」步骤遇到异常：按下F5启动「运行和调试」时，终端面板输出以下错误：

*  Executing task: .venv\Scripts\python -m pip install -r requirements.txt 

<3>WSL (9) ERROR: CreateProcessEntryCommon:577: execvpe .venv\Scripts\python failed 2
<3>WSL (9) ERROR: CreateProcessEntryCommon:586: Create process not expected to return

*  The terminal process "C:\Windows\System32\wsl.exe -e .venv\Scripts\python -m pip install -r requirements.txt" terminated with exit code: 1. 
*  Terminal will be reused by tasks, press any key to close it. 

教程给出的唯一修复提示是：

如果在Windows上运行遇到问题，请确保Visual Studio Code的默认终端未设置为WSL Bash。

我已执行以下操作，但问题依旧：

• 通过快捷键Shift+Ctrl+P打开「Terminal:Set Default Profile」，选择了PowerShell作为默认终端，未选择WSL或Git Bash。
• 使用Windows 10设备，Azure Function项目位于独立文件夹，配置了专属.venv虚拟环境，Get-Command python命令确认指向该虚拟环境中的python.exe。
• 从PowerShell进入项目文件夹后，执行code .启动VSCode。

补充：终端面板右侧显示「wsl task」提示。

请问为何VSCode持续尝试运行WSL？如何阻止该行为？

解决方法 #

1. 检查并修改tasks.json配置 #

VSCode的任务运行配置可能强制指定了WSL环境，需手动调整：

• 打开项目中的.vscode/tasks.json文件。
• 移除所有command中的wsl.exe -e前缀，直接使用虚拟环境的Python路径，示例配置：

  {
    "label": "pip install",
    "type": "shell",
    "command": "${workspaceFolder}\\.venv\\Scripts\\python.exe -m pip install -r requirements.txt",
    "args": [],
    "problemMatcher": [],
    "options": {
      "shell": {
        "executable": "powershell.exe",
        "args": ["-NoProfile", "-ExecutionPolicy", "Bypass"]
      }
    }
  }
  

2. 调整Azure Functions扩展设置 #

Azure Functions扩展可能优先调用WSL，需修改以下设置：

• 打开VSCode设置（快捷键Ctrl+,），搜索azureFunctions.useWsl，将选项设置为false。
• 搜索azureFunctions.pythonVenv，将其值设置为项目虚拟环境的Python路径，例如.venv\Scripts\python.exe。

3. 重置工作区终端配置 #

若工作区存在自定义配置强制使用WSL：

• 打开.vscode/settings.json文件，检查是否存在terminal.integrated.defaultProfile.windows或terminal.integrated.shell.windows配置，确保其值为"PowerShell"或PowerShell可执行文件的完整路径。
• 删除所有与WSL相关的配置项。

4. 确认虚拟环境关联 #

确保VSCode正确识别项目的虚拟环境：

• 点击左下角状态栏的Python版本标识，选择项目的.venv虚拟环境。
• 重启终端，执行python --version验证是否使用虚拟环境中的Python。

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