WSL1/Ubuntu22.04下VSCode调试C++遇GDB终端权限错误求助

环境信息 #

• Windows10版本：10.0.19045.2728
• VSCode版本：1.76.2
• WSL版本：WSL1
• Ubuntu版本：22.04
• 工具版本：G++ 11.3.0、GDB 12.1
• 已安装扩展：C++扩展1.14.5、WSL扩展

问题描述 #

程序在VSCode内置终端编译运行正常，但选择「Debug C/C++ file」或「Run C/C++ file」时触发错误：

"warning: GDB: Failed to set controlling terminal: Operation not permitted\n"
[1] + Done                        "/usr/bin/gdb" --interpreter=mi -- tty=${DbgTerm} 0<"/tmp/Microsoft-MIEngine-In-itqt2xnq.hf2" 1>"/tmp/Microsoft-MIEngine-Out-mc0wqh2g.wfn"

已尝试设置launch.json中的"externalConsole":false，问题未解决，当前launch.json配置如下：

{
    "version": "0.2.0",
    "configurations": [
       {
            "name": "(gdb) Launch",
            "type": "cppdbg",
            "request": "launch",
            "program": "${workspaceRoot}/hello",
            "args": [],
            "stopAtEntry": true,
            "cwd": "${workspaceRoot}",
            "environment": [],
            "externalConsole": false,
            "MIMode": "gdb",
            "setupCommands": [
                {
                    "description": "Enable pretty-printing for gdb",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                },
                {
                    "description":  "Set Disassembly Flavor to Intel",
                    "text": "-gdb-set disassembly-flavor intel",
                    "ignoreFailures": true
                }
            ]
        },
        {
            "name": "(gdb) Attach",
            "request": "attach",
            "type": "cppdbg",
            "processId": "${command:pickProcess}",
            "program": "${workspaceFolder}/hello",
            // "cwd": "${workspaceFolder}",
            "MIMode": "gdb",
            "miDebuggerPath": "/usr/bin/gdb",
            "setupCommands": [
                {
                    "description": "Enable pretty-printing for gdb",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                },
                {
                    "description": "Provide backtrace to all threads",
                    "text": "thread apply all bt",
                    "ignoreFailures": true
                },
                {
                    "description": "Catch an exception when thrown",
                    "text": "catch throw",
                    "ignoreFailures": true
                },
                {
                    "description": "Ignore SIG34",
                    "text": "handle SIG34 nostop pass noprint",
                    "ignoreFailures": true
                }
            ]
        }
   ]
}

解决思路 #

• 切换到WSL2：WSL1在终端控制、系统调用兼容性上存在局限，GDB的终端控制操作依赖Linux内核特性，WSL2基于完整Linux内核，大概率能解决该权限问题。备份WSL1数据后，执行wsl --set-version Ubuntu-22.04 2完成切换。
• 修改GDB启动参数：在launch.json的(gdb) Launch配置中添加"miDebuggerArgs": "--tty=/dev/null"，强制GDB忽略终端设置，避免权限校验。
• 降级GDB版本：GDB 12.x在WSL1下可能存在兼容性问题，尝试降级到GDB 10.x版本，执行sudo apt install gdb=10.1-2ubuntu2，并在launch.json中指定"miDebuggerPath": "/usr/bin/gdb"指向降级后的GDB。
• 检查VSCode扩展兼容性：将C++扩展降级到1.13.x版本，部分新版本扩展在WSL1环境下的调试逻辑可能存在冲突，通过扩展面板的「Install Another Version」选项选择旧版本。
• 手动指定终端设备：在WSL中执行tty命令获取当前终端路径（如/dev/pts/0），在launch.json中添加"environment": [{"name": "DbgTerm", "value": "/dev/pts/0"}]，强制指定调试终端路径。

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