tasks.json负责编译，launch.json负责调试，通过prelaunchtask字段联动；windows下常见问题包括路径反斜杠未转义、gdb.exe路径错误、program指向的可执行文件不存在或不匹配。
直接说结论：tasks.json 负责编译，launch.json 负责调试，两者靠 preLaunchTask 字段联动；Windows 下最常踩的坑是路径反斜杠、gdb.exe 路径没写对、program 指向的可执行文件根本不存在。
tasks.json 怎么写才能编译成功
核心是让 VS Code 知道用什么命令、在哪儿执行、输出到哪。Windows 上用 MinGW-w64 最常见，command 必须是完整路径或确保在系统 PATH 里；args 里必须带 -g（否则调试时看不到变量），${file} 是当前打开的 .cpp 文件，但多文件项目得改成 "${fileDirname}/*.cpp"。
容易出错的点：
-
cwd不设或设错会导致头文件找不到（比如#include "utils.h"报错） - Windows 路径中反斜杠
在 JSON 里要写成\或直接用正斜杠/（VS Code 支持） -
problemMatcher必须配$gcc，不然编译错误不显示在“问题”面板 - 如果用了
group: { "kind": "build", "isDefault": true }，按Ctrl+Shift+B才能一键触发
示例（MinGW-w64，单文件）：
{
"version": "2.0.0",
"tasks": [
{
"label": "g++ build",
"type": "shell",
"command": "g++",
"args": [
"-g",
"${file}",
"-o",
"${fileDirname}/${fileBasenameNoExtension}.exe"
],
"options": {
"cwd": "${fileDirname}"
},
"problemMatcher": ["$gcc"],
"group": "build",
"isDefault": true
}
]
}
launch.json 的 program 和 preLaunchTask 必须严格对应
program 字段填的是「调试器要加载的可执行文件路径」，不是源码路径，也不是编译命令。它必须和 tasks.json 中 args 里 -o 后面生成的路径完全一致——包括扩展名（Windows 是 .exe）、大小写、甚至空格。
preLaunchTask 填的是 tasks.json 里某个任务的 label 值，不是文件名也不是命令。VS Code 不会自动猜，拼错一个字符就静默失败，F5 后提示 “无法启动程序”，但不告诉你为什么。
关键细节：
-
type必须是"cppdbg"，不是"cpp"或"c" -
MIMode设为"gdb"，且miDebuggerPath必须指向真实存在的gdb.exe（例如"C:\mingw64\bin\gdb.exe"） -
externalConsole设为true才能看到cin/cout输入输出（否则黑窗口一闪而过） -
stopAtEntry设为false，否则一启动就停在main入口，不方便跳过初始化逻辑
示例（与上面 tasks.json 匹配）：
{
"version": "0.2.0",
"configurations": [
{
"name": "(gdb) Launch",
"type": "cppdbg",
"request": "launch",
"program": "${fileDirname}/${fileBasenameNoExtension}.exe",
"args": [],
"stopAtEntry": false,
"cwd": "${fileDirname}",
"environment": [],
"externalConsole": true,
"MIMode": "gdb",
"miDebuggerPath": "C:\mingw64\bin\gdb.exe",
"preLaunchTask": "g++ build"
}
]
}
为什么改了配置还是断点不命中
90% 的情况是：可执行文件没带调试信息，或者调试器加载了旧版本。确认三件事：
- 编译命令里有没有
-g（tasks.json的args） -
program路径是否真能访问到文件（在资源管理器里手动打开试试） - F5 前有没有看到终端弹出“正在构建…”——如果没有，说明
preLaunchTask根本没触发，检查 label 是否拼写一致、tasks.json 是否在.vscode/下、文件编码是不是 UTF-8 无 BOM
另一个隐蔽问题：c_cpp_properties.json 里 compilerPath 如果指向了别的 g++（比如 WSL 里的），会导致 IntelliSense 显示正常，但本地 tasks.json 调用的却是另一套工具链，生成的二进制不兼容 gdb。
最麻烦的其实是路径同步——tasks.json 写了 -o xxx.exe，launch.json 就得严格写 xxx.exe，少个点、多个空格、大小写不一致，全都不行。别信“应该差不多”，VS Code 不做任何容错。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
