VSCode中GDB调试C++二进制文件时出现Python初始化错误

问题现象 #

调试时弹出错误：

Unable to start debugging. Unable to establish a connection to GDB. The following message was written to stderr:

Could not find platform independent libraries <prefix>
Could not find platform dependent libraries <exec_prefix>
Python path configuration:
PYTHONHOME = (not set)
PYTHONPATH = (not set)
program name = '/usr/bin/python'
isolated = 0
environment = 1
user site = 1
safe_path = 0
import site = 1
is in build tree = 0
stdlib dir = '/usr/lib/python3.11'
sys._base_executable = '/usr/bin/python'
sys.base_prefix = '/usr'
sys.base_exec_prefix = '/usr'
sys.platlibdir = 'lib'
sys.executable = '/usr/bin/python'
sys.prefix = '/usr'
sys.exec_prefix = '/usr'
sys.path = [
'/usr/lib/python311.zip',
'/usr/lib/python3.11',
'/usr/lib/python3.11/lib-dynload',
]
Python Exception <class 'ModuleNotFoundError'>: No module named 'encodings'
Python not initialized

See Output Window for details

当前launch.json配置：

{
  // Use IntelliSense to learn about possible attributes.
  // Hover to view descriptions of existing attributes.
  // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
  "version": "0.2.0",
  "configurations": [
    {
      "name": "(gdb) Launch",
      "type": "cppdbg",
      "request": "launch",
      "program": "${workspaceFolder}/a.exe",
      "args": [],
      "stopAtEntry": false,
      "cwd": "${fileDirname}",
      "environment": [],
      "externalConsole": false,
      "MIMode": "gdb",
      "miDebuggerPath": "C:\\msys64\\usr\\bin\\gdb.exe",
      "logging": {"engineLogging" : true},
      "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
          }
      ]
    }

  ]
}

问题原因 #

你使用的是MSYS2环境下的GDB，该GDB依赖MSYS2自带的Python运行环境。但VSCode启动时没有加载MSYS2的环境变量，导致GDB调用Python时无法找到正确的系统库和模块（比如encodings），进而初始化失败。

解决办法 #

方法1：在launch.json中添加MSYS2环境变量 #

修改launch.json的environment字段，添加MSYS2必要的环境变量，让GDB能找到Python依赖：

"environment": [
    {"name": "PYTHONHOME", "value": "C:\\msys64\\usr"},
    {"name": "PYTHONPATH", "value": "C:\\msys64\\usr\\lib\\python3.11;C:\\msys64\\usr\\lib\\python3.11\\site-packages"},
    {"name": "PATH", "value": "C:\\msys64\\usr\\bin;${env:PATH}"}
],

注意：如果你的MSYS2安装路径不是C:\\msys64，或者Python版本不是3.11，需要对应修改路径。

方法2：通过MSYS2终端启动VSCode #

打开MSYS2的终端（比如MSYS2 UCRT64），在终端里输入code命令启动VSCode。这样VSCode会继承MSYS2的全部环境变量，GDB就能正常调用Python。

方法3：禁用GDB的Python依赖（临时方案） #

如果不需要GDB的Python特性（比如pretty-printing），可以修改launch.json的setupCommands，移除-enable-pretty-printing，并在GDB启动时禁用Python：
在setupCommands中添加：

{
    "description": "Disable Python in GDB",
    "text": "set python off",
    "ignoreFailures": false
}

同时移除之前的-enable-pretty-printing命令，因为该功能依赖Python。

另外，关于你提到的找不到输出窗口：在VSCode中，点击左侧活动栏的「运行和调试」图标（Ctrl+Shift+D），然后在面板底部找到「输出」选项卡，切换到「C/C++: gdb」的输出即可查看详细日志。

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