MSys2 64位gdb出现Python错误无法正常运行

问题描述 #

通过MSys2安装MinGW、GDB和GCC后，调试器在VS Code、CMD及PowerShell中均无法正常工作。尝试删除PYTHONPATH环境变量无效，其他组件（含Python）运行正常。执行gdb --version时出现以下错误：

C:\Users\cseh_>gdb --version
Python path configuration:
  PYTHONHOME = 'C:\Users\cseh_\AppData\Local\Programs\Python\Python310'
  PYTHONPATH = 'C:\Users\cseh_\AppData\Local\Programs\Python\Python310'
  program name = 'c:\msys64\mingw64/bin/python'
  isolated = 0
  environment = 1
  user site = 1
  import site = 1
  sys._base_executable = 'c:\msys64\mingw64/bin/python.exe'
  sys.base_prefix = 'C:\Users\cseh_\AppData\Local\Programs\Python\Python310'
  sys.base_exec_prefix = 'C:\Users\cseh_\AppData\Local\Programs\Python\Python310'
  sys.platlibdir = 'lib'
  sys.executable = 'c:\msys64\mingw64/bin/python.exe'
  sys.prefix = 'C:\Users\cseh_\AppData\Local\Programs\Python\Python310'
  sys.exec_prefix = 'C:\Users\cseh_\AppData\Local\Programs\Python\Python310'
  sys.path = [
    'C:\Users\cseh_\AppData\Local\Programs\Python\Python310',
    'C:\Users\cseh_\AppData\Local\Programs\Python\Python310\lib\python310.zip',
    'C:\Users\cseh_\AppData\Local\Programs\Python\Python310\lib\python3.10',
    'C:\Users\cseh_\AppData\Local\Programs\Python\Python310\lib\python3.10\lib-dynload',
    '',
  ]
Fatal Python error: init_fs_encoding: failed to get the Python codec of the filesystem encoding
Python runtime state: core initialized
ModuleNotFoundError: No module named 'encodings'

Current thread 0x00002a90 (most recent call first):
  <no Python frame>

更新：在MSys2 Shell中执行unset PYTHONHOME和unset PYTHONPATH后问题仍未解决，相关环境变量输出如下：

cseh_@Develop08 MSYS ~
$ printenv
ProgramFiles(x86)=C:\Program Files (x86)
!::=::\
CommonProgramFiles(x86)=C:\Program Files (x86)\Common Files
SHELL=/usr/bin/bash
NUMBER_OF_PROCESSORS=8
PROCESSOR_LEVEL=6
TERM_PROGRAM_VERSION=3.6.2
PKG_CONFIG_PATH=/usr/lib/pkgconfig:/usr/share/pkgconfig:/lib/pkgconfig
USERDOMAIN_ROAMINGPROFILE=DEVELOP08
HOSTNAME=Develop08
PROGRAMFILES=C:\Program Files
MSYSTEM=MSYS
PATHEXT=.COM;.EXE;.BAT;.CMD;.VBS;.VBE;.JS;.JSE;.WSF;.WSH;.MSC
ORIGINAL_TEMP=/c/Users/cseh_/AppData/Local/Temp
OS=Windows_NT
HOMEDRIVE=C:
MSYSTEM_CARCH=x86_64
USERDOMAIN=DEVELOP08
PWD=/home/cseh_
USERPROFILE=C:\Users\cseh_
MANPATH=/usr/local/man:/usr/share/man:/usr/man:/share/man
PRINTER=Xerox B210 (XRX9C934EAD9213)
TZ=Europe/Budapest
tmp=C:\Users\cseh_\AppData\Local\Temp
ALLUSERSPROFILE=C:\ProgramData
ORIGINAL_PATH=/c/Windows/System32:/c/Windows:/c/Windows/System32/Wbem:/c/Windows/System32/WindowsPowerShell/v1.0/
CommonProgramW6432=C:\Program Files\Common Files
HOME=/home/cseh_
USERNAME=cseh_
VBOX_MSI_INSTALL_PATH=C:\Program Files\Oracle\VirtualBox\
OneDrive=C:\Users\cseh_\OneDrive
COMSPEC=C:\WINDOWS\system32\cmd.exe
APPDATA=C:\Users\cseh_\AppData\Roaming
SYSTEMROOT=C:\WINDOWS
LOCALAPPDATA=C:\Users\cseh_\AppData\Local
COMPUTERNAME=DEVELOP08
INFOPATH=/usr/local/info:/usr/share/info:/usr/info:/share/info
PYTHONPATH=C:\Users\cseh_\AppData\Local\Programs\Python\Python310
TERM=xterm
LOGONSERVER=\\DEVELOP08
ZES_ENABLE_SYSMAN=1
PYTHONHOME=C:\Users\cseh_\AppData\Local\Programs\Python\Python310
USER=cseh_
PSModulePath=C:\Program Files\WindowsPowerShell\Modules;C:\WINDOWS\system32\WindowsPowerShell\v1.0\Modules
TEMP=/tmp
temp=C:\Users\cseh_\AppData\Local\Temp
MSYSTEM_CHOST=x86_64-pc-msys
ORIGINAL_TMP=/c/Users/cseh_/AppData/Local/Temp
SHLVL=1
PROCESSOR_REVISION=8c01
DriverData=C:\Windows\System32\Drivers\DriverData
COMMONPROGRAMFILES=C:\Program Files\Common Files
LC_CTYPE=en_US.UTF-8
PROCESSOR_IDENTIFIER=Intel64 Family 6 Model 140 Stepping 1, GenuineIntel
SESSIONNAME=Console
PS1=\[\e]0;\w\a\]\n\[\e[32m\]\u@\h \[\e[35m\]$MSYSTEM\[\e[0m\] \[\e[33m\]\w\[\e[0m\]\n\$
HOMEPATH=\Users\cseh_
MSYSCON=mintty.exe
TMP=/tmp
CONFIG_SITE=/etc/config.site
PATH=/usr/local/bin:/usr/bin:/bin:/opt/bin:/c/Windows/System32:/c/Windows:/c/Windows/System32/Wbem:/c/Windows/System32/WindowsPowerShell/v1.0/:/usr/bin/site_perl:/usr/bin/vendor_perl:/usr/bin/core_perl
ProgramW6432=C:\Program Files
MSYSTEM_PREFIX=/usr
WINDIR=C:\WINDOWS
PROCESSOR_ARCHITECTURE=AMD64
PUBLIC=C:\Users\Public
SYSTEMDRIVE=C:
OLDPWD=/
GOPATH=C:\Users\cseh_\go
TERM_PROGRAM=mintty
ProgramData=C:\ProgramData
_=/usr/bin/printenv

cseh_@Develop08 MSYS ~
$ unset PYTHONHOME

cseh_@Develop08 MSYS ~
$ unset PYTHONPATH

cseh_@Develop08 MSYS ~
$ printenv
ProgramFiles(x86)=C:\Program Files (x86)
!::=::\
CommonProgramFiles(x86)=C:\Program Files (x86)\Common Files
SHELL=/usr/bin/bash
NUMBER_OF_PROCESSORS=8
PROCESSOR_LEVEL=6
TERM_PROGRAM_VERSION=3.6.2
PKG_CONFIG_PATH=/usr/lib/pkgconfig:/usr/share/pkgconfig:/lib/pkgconfig
USERDOMAIN_ROAMINGPROFILE=DEVELOP08
HOSTNAME=Develop08
PROGRAMFILES=C:\Program Files
MSYSTEM=MSYS
PATHEXT=.COM;.EXE;.BAT;.CMD;.VBS;.VBE;.JS;.JSE;.WSF;.WSH;.MSC
ORIGINAL_TEMP=/c/Users/cseh_/AppData/Local/Temp
OS=Windows_NT
HOMEDRIVE=C:
MSYSTEM_CARCH=x86_64
USERDOMAIN=DEVELOP08
PWD=/home/cseh_
USERPROFILE=C:\Users\cseh_
MANPATH=/usr/local/man:/usr/share/man:/usr/man:/share/man
PRINTER=Xerox B210 (XRX9C934EAD9213)
TZ=Europe/Budapest
tmp=C:\Users\cseh_\AppData\Local\Temp
ALLUSERSPROFILE=C:\ProgramData
ORIGINAL_PATH=/c/Windows/System32:/c/Windows:/c/Windows/System32/Wbem:/c/Windows/System32/WindowsPowerShell/v1.0/
CommonProgramW6432=C:\Program Files\Common Files
HOME=/home/cseh_
USERNAME=cseh_
VBOX_MSI_INSTALL_PATH=C:\Program Files\Oracle\VirtualBox\
OneDrive=C:\Users\cseh_\OneDrive
COMSPEC=C:\WINDOWS\system32\cmd.exe
APPDATA=C:\Users\cseh_\AppData\Roaming
SYSTEMROOT=C:\WINDOWS
LOCALAPPDATA=C:\Users\cseh_\AppData\Local\COMPUTERNAME=DEVELOP08
INFOPATH=/usr/local/info:/usr/share/info:/usr/info:/share/info
TERM=xterm
LOGONSERVER=\\DEVELOP08
ZES_ENABLE_SYSMAN=1
USER=cseh_
PSModulePath=C:\Program Files\WindowsPowerShell\Modules;C:\WINDOWS\system32\WindowsPowerShell\v1.0\Modules
TEMP=/tmp
temp=C:\Users\cseh_\AppData\Local\Temp
MSYSTEM_CHOST=x86_64-pc-msys
ORIGINAL_TMP=/c/Users/cseh_/AppData/Local/Temp
SHLVL=1
PROCESSOR_REVISION=8c01
DriverData=C:\Windows\System32\Drivers\DriverData
COMMONPROGRAMFILES=C:\Program Files\Common Files
LC_CTYPE=en_US.UTF-8
PROCESSOR_IDENTIFIER=Intel64 Family 6 Model 140 Stepping 1, GenuineIntel
SESSIONNAME=Console
PS1=\[\e]0;\w\a\]\n\[\e[32m\]\u@\h \[\e[35m\]$MSYSTEM\[\e[0m\] \[\e[33m\]\w\[\e[0m\]\n\$
HOMEPATH=\Users\cseh_
MSYSCON=mintty.exe
TMP=/tmp
CONFIG_SITE=/etc/config.site
PATH=/usr/local/bin:/usr/bin:/bin:/opt/bin:/c/Windows/System32:/c/Windows:/c/Windows/System32/Wbem:/c/Windows/System32/WindowsPowerShell/v1.0/:/usr/bin/site_perl:/usr/bin/vendor_perl:/usr/bin/core_perl
ProgramW6432=C:\Program Files
MSYSTEM_PREFIX=/usr
WINDIR=C:\WINDOWS
PROCESSOR_ARCHITECTURE=AMD64
PUBLIC=C:\Users\Public
SYSTEMDRIVE=C:
OLDPWD=/
GOPATH=C:\Users\cseh_\go
TERM_PROGRAM=mintty
ProgramData=C:\ProgramData
_=/usr/bin/printenv

解决方法 #

1. 删除系统级PYTHONHOME和PYTHONPATH变量 #

• 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
• 在「用户变量」或「系统变量」列表中找到PYTHONHOME和PYTHONPATH，直接删除这两个变量
• 重启所有终端、VS Code，确保新的环境变量生效

2. 使用MinGW64 Shell验证GDB #

• 打开MSys2的MinGW64 Shell（不要用MSYS Shell）
• 执行gdb --version，确认是否能正常输出版本信息
• 如果在此环境下正常，说明问题出在外部终端的环境变量冲突

3. 配置VS Code指定正确的GDB路径 #

• 打开VS Code的.vscode/launch.json文件，修改miDebuggerPath为MSys2 MinGW64目录下的GDB路径，示例：

  {
      "version": "0.2.0",
      "configurations": [
          {
              "name": "g++.exe - 生成和调试活动文件",
              "type": "cppdbg",
              "request": "launch",
              "program": "${fileDirname}\\${fileBasenameNoExtension}.exe",
              "args": [],
              "stopAtEntry": false,
              "cwd": "${fileDirname}",
              "environment": [],
              "externalConsole": false,
              "MIMode": "gdb",
              "miDebuggerPath": "C:/msys64/mingw64/bin/gdb.exe",
              "setupCommands": [
                  {
                      "description": "为 gdb 启用整齐打印",
                      "text": "-enable-pretty-printing",
                      "ignoreFailures": true
                  }
              ],
              "preLaunchTask": "C/C++: g++.exe 生成活动文件"
          }
      ]
  }
  

• 确保路径指向C:/msys64/mingw64/bin/gdb.exe，而非系统Python关联的路径

4. 修复MSys2的Python关联 #

• 打开MinGW64 Shell，执行pacman -S mingw-w64-x86_64-python，安装MinGW版本的Python
• 执行which python，确认输出为/mingw64/bin/python，确保MSys2使用自身携带的Python环境

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