VS Code使用GDB配置C++调试环境不生效问题

两个报错对应两处独立的配置错误：

• 编译任务执行时的工作目录和源码存放目录不匹配，导致g++运行时找不到myfile.cpp源文件
• VS Code的C/C插件没有正确识别MinGW g的标准库搜索路径，触发<iostream>头文件引用报错
  目录下存在的myfile.exe是历史编译残留文件，和当前编译流程无关，路径配置错误时g++不会读取源文件生成新的可执行程序，旧文件自然无法匹配最新代码正常运行。

修复源文件找不到的编译错误 #

• 首先确认VS Code打开的是存放myfile.cpp的源码文件夹本身，不是单个cpp文件，也不是上层父目录。正确操作是启动VS Code后选择「打开文件夹」，选中你存放cpp源码的目录，左侧资源管理器能直接看到myfile.cpp才算操作正确。
• 打开.vscode/tasks.json，替换为如下标准配置，重点确认工作目录和编译参数的路径变量：

{
    "version": "2.0.0",
    "tasks": [
        {
            "type": "cppbuild",
            "label": "C/C++: g++.exe 生成活动文件",
            "command": "g++.exe",
            "args": [
                "-fdiagnostics-color=always",
                "-g",
                "-std=c++14",
                "${file}",
                "-o",
                "${fileDirname}\\${fileBasenameNoExtension}.exe"
            ],
            "options": {
                "cwd": "${fileDirname}"
            },
            "problemMatcher": [
                "$gcc"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            }
        }
    ]
}

• 配置保存后关闭所有已打开的VS Code终端，确保当前编辑器激活的标签页是myfile.cpp，再按Ctrl+Shift+B执行构建，就不会触发找不到源文件的报错。

修复头文件引用错误 #

• 先验证MinGW安装有效性：打开系统PowerShell，执行g++ -v，如果能正常输出版本信息，再执行g++ -print-file-name=include，记下返回的MinGW内置include目录路径；如果执行g++ -v提示找不到命令，先把MinGW安装目录下的bin文件夹完整路径加到系统环境变量Path中，重启VS Code再继续后续操作。
• 打开.vscode/c_cpp_properties.json，将compilerPath替换为你本地g++.exe的完整路径，MSYS方式安装的MinGW默认路径为C:/msys64/mingw64/bin/g++.exe，参考配置如下：

{
    "configurations": [
        {
            "name": "Win32",
            "includePath": [
                "${workspaceFolder}/**"
            ],
            "defines": [
                "_DEBUG",
                "UNICODE",
                "_UNICODE"
            ],
            "compilerPath": "C:/msys64/mingw64/bin/g++.exe",
            "cStandard": "c17",
            "cppStandard": "c++14",
            "intelliSenseMode": "windows-gcc-x64"
        }
    ],
    "version": 4
}

• 保存配置后按Ctrl+Shift+P调出命令面板，执行C/C++: Reset IntelliSense Database，等待索引重建完成后，头文件报错会自动消失。

校验运行配置 #

打开.vscode/launch.json，确认可执行文件路径、预编译任务标签和tasks.json中的配置完全对应，参考配置如下：

{
    "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 生成活动文件"
        }
    ]
}

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