VSCode调试C++遇preLaunchTask退出码-1，断点无效求助

在Windows 10系统下使用VSCode调试C++文件，严格遵循官方操作指引后仍出现preLaunchTask " " terminated with exit code -1错误，点击「Debug Anyway」选项后调试器无法命中任何断点。

相关信息 #

• 测试代码：

#include <iostream>
#include <vector>
#include <string>

using namespace std;

int main()
{
    vector<string> msg {"Hello", "C++", "World", "from", "VS Code", "and the C++ extension!"};

    for (const string& word : msg)
    {
        cout << word << " ";
    }
    cout << endl;
    return 0;
}

• C++文件路径：C:\Users\ADMIN\Desktop\Program\CppNew\helloworld.cpp
• 使用g++.exe进行调试
• tasks.json配置：

{ //tasks.json
    "tasks": [
        {
            "type": "cppbuild",
            "label": "BuildProject",
            "command": "C:\\msys64\\mingw64\\bin\\g++.exe",
            "args": [
                "-fdiagnostics-color=always",
                "-g",
                "${file}",
                "-o",
                "${fileDirname}\\helloworld.exe"
            ],
            "options": {
                "cwd": "${fileDirname}"
            },
            "problemMatcher": [
                "$gcc"
            ],
            "group": "build",
            "detail": "Task generated by Debugger."
        }
    ],
    "version": "2.0.0"
}

• launch.json配置：

{ //launch.json
    "version": "0.2.0",
    "configurations": [
        {
            "name": "C/C++: g++.exe build and debug active file",
            "type": "cppdbg",
            "request": "launch",
            "program": "${fileDirname}\\${fileBasenameNoExtension}.exe",
            "args": [],
            "stopAtEntry": true,
            "cwd": "${fileDirname}",
            "environment": [],
            "externalConsole": false,
            "MIMode": "gdb",
            "miDebuggerPath": "C:\\msys64\\mingw64\\bin\\gdb.exe",
            "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
                }
            ],
            "preLaunchTask": "BuildProject"
        }
    ]
}

• 调试控制台日志：

=thread-group-added,id="i1"
GNU gdb (GDB) 12.1
Copyright (C) 2022 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
Type "show copying" and "show warranty" for details.
This GDB was configured as "x86_64-w64-mingw32".
Type "show configuration" for configuration details.
For bug reporting instructions, please see:
<https://www.gnu.org/software/gdb/bugs/>.
Find the GDB manual and other documentation resources online at:
    <http://www.gnu.org/software/gdb/documentation/>.

For help, type "help".
Type "apropos word" to search for commands related to "word".
Warning: Debuggee TargetArchitecture not detected, assuming x86_64.
=cmd-param-changed,param="pagination",value="off"

Thread 1 hit Breakpoint 1, 0x00007ff7e987146c in main ()
Loaded 'C:\Windows\SYSTEM32\ntdll.dll'. Symbols loaded.
Loaded 'C:\Windows\System32\kernel32.dll'. Symbols loaded.
Loaded 'C:\Windows\System32\KernelBase.dll'. Symbols loaded.
Loaded 'C:\Windows\System32\msvcrt.dll'. Symbols loaded.
Loaded 'C:\msys64\mingw64\bin\libgcc_s_seh-1.dll'. Symbols loaded.
Loaded 'C:\msys64\mingw64\bin\libstdc++-6.dll'. Symbols loaded.
Execute debugger commands using "-exec <command>", for example "-exec info registers" will list registers in use (when GDB is the debugger)
Single stepping until exit from function main,
which has no line number information.
[Thread 11160.0x2ff4 exited with code 0]
[Thread 11160.0x459c exited with code 0]
[Thread 11160.0x37bc exited with code 0]
[Inferior 1 (process 11160) exited normally]
The program 'c:\Users\ADMIN\Desktop\Program\CppNew\helloworld.exe' has exited with code 0 (0x00000000).

• 工具版本：
  • g++ (Rev7, Built by MSYS2 project) 12.2.0
  • gcc (Rev7, Built by MSYS2 project) 12.2.0
  • GNU gdb (GDB) 12.1
• 已配置到PATH的目录：C:\msys64\mingw64\bin

已尝试通过MSYS2重装MinGW、修改配置文件中的绝对路径等操作，问题仍未解决。

1. 修复preLaunchTask错误 #

错误提示preLaunchTask " "说明任务匹配失败，可按以下步骤处理：

• 关闭VSCode，删除项目根目录下的.vscode文件夹，重新生成调试配置
• 确保tasks.json的label和launch.json的preLaunchTask完全一致（包括大小写）
• 手动执行一次BuildProject任务（Ctrl+Shift+B选择该任务），确认编译成功后再启动调试

2. 解决断点无法命中问题 #

调试日志显示which has no line number information，说明调试符号未正确生成或关联，可尝试：

• 修改tasks.json的输出文件名，使用变量替代固定名称，避免文件不匹配：

  "args": [
      "-fdiagnostics-color=always",
      "-g",
      "${file}",
      "-o",
      "${fileDirname}\\${fileBasenameNoExtension}.exe"
  ]
  

• 清理项目目录下的旧exe文件，重新编译
• 将launch.json中的externalConsole设为true，避免控制台输出问题干扰调试
• 检查VSCode的C/C++扩展设置，确保没有覆盖符号相关配置

3. 额外排查步骤 #

• 打开命令提示符，进入文件目录，手动执行编译命令：

  g++ -g helloworld.cpp -o helloworld.exe
  

  再用gdb调试：

  gdb helloworld.exe
  

  输入break main和run，判断是VSCode配置问题还是工具链问题
• 重新安装完整的MinGW64工具链：

  pacman -S mingw-w64-x86_64-gcc mingw-w64-x86_64-gdb
  

• 检查系统PATH，确保C:\msys64\mingw64\bin在最前面，避免与其他版本的gcc/gdb冲突

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