Ubuntu 20.04下VS Code启动Python调试器报bin/sh不存在错误

运行环境 #

• 操作系统：Ubuntu 20.04
• VS Code版本：1.59.1
• Python版本：3.8.5（已安装官方Python扩展）

异常现象 #

启动Python调试器时终端抛出错误：终端进程启动失败：shell可执行文件"bin/sh"的路径不存在。

• 代码中添加breakpoint()调用ipdb可正常调试
• VS Code调试C#项目功能正常，可正常触发断点

错误根因 #

VS Code集成终端的默认shell配置填写了相对路径bin/sh，缺失路径开头的根目录标识/，导致系统找不到对应shell可执行文件。C#调试、ipdb调试未调用VS Code集成终端的默认shell配置，因此不受影响。

修复步骤 #

方案一：修改全局集成终端配置（永久生效） #

1. 使用快捷键Ctrl+,打开VS Code设置页面
2. 搜索配置项terminal.integrated.shell.linux
3. 将配置值从bin/sh修改为绝对路径/bin/sh，需默认使用bash可替换为/bin/bash
4. 重启VS Code后重新启动Python调试即可

方案二：仅修改Python调试配置（不影响全局终端设置） #

1. 打开项目根目录下.vscode/launch.json文件，无该文件可在调试面板点击「创建launch.json文件」，选择Python环境自动生成
2. 在对应Python调试配置项中新增"console": "internalConsole"参数，强制调试使用内置调试控制台而非集成终端，参考配置如下：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: 当前文件",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "internalConsole",
            "justMyCode": true
        }
    ]
}

3. 保存配置后直接启动调试即可，无需重启VS Code

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