VSCode使用MSYS2 GDB调试CPP项目无法单步运行问题求助

1. 检查编译任务的调试参数配置 #

你当前launch.json中指定的preLaunchTask为C/C++: g++.exe build active file，需要打开对应tasks.json文件，确认该编译任务的g++参数中必须包含-g选项，同时不能存在-s、-O1/-O2/-O3这类会剥离调试信息或开启代码优化的参数。
正确的编译命令示例：

g++.exe -g ${file} -o ${fileDirname}\\${fileBasenameNoExtension}.exe

-g参数的作用是生成GDB可识别的调试符号，缺失该参数时GDB无法关联代码行和二进制执行逻辑，直接导致断点、单步执行失效。

2. 排查路径兼容性问题 #

确认待调试的C++文件完整路径无中文、空格、特殊字符，MSYS2环境下的GDB对非ASCII、含特殊字符的路径兼容性极差，会出现调试符号加载失败的问题。

3. 调整控制台配置测试 #

将launch.json中的externalConsole参数改为true，部分Windows系统下VSCode内置终端和GDB的MI交互存在适配问题，使用外置控制台可规避该类异常。

4. 验证编译器与GDB版本匹配 #

你当前使用的GDB路径为C:\\msys64\\mingw64\\bin\\gdb.exe，需要确认编译用的g++也来自同一路径下的mingw64环境，不能混用MSYS2其他子环境（如ucrt64、clang64、mingw32）的编译器，版本不匹配会导致调试符号格式无法被GDB识别。

5. 最小场景复现验证 #

使用最简测试代码验证配置是否生效：

#include <iostream>
int main() {
    int test = 1; // 此处手动打断点
    std::cout << "Hello World" << std::endl;
    return 0;
}

修改配置后重新执行编译调试，确认断点可正常命中、单步执行功能恢复。

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