能跑起来的最小可行配置是：tasks.json必须用-g编译出可执行文件，launch.json的program路径须与输出严格一致且prelaunchtask匹配任务label；漏-g或路径错位会导致断点失效。
能跑起来的最小可行配置，就两件事：tasks.json得编译出带调试信息的可执行文件，launch.json得指向它并配对preLaunchTask。其余参数不填也能启动，但漏掉-g或路径错位，断点就永远灰着。
tasks.json 必须生成含调试信息的二进制
很多人编译成功却无法断点，根本原因是没加-g。VSCode 不会自动帮你加这个 flag，它只忠实地执行你写的命令。
-
"args"里必须显式包含-g，否则 GDB/Lldb 没有符号表，断点无效 - 多文件项目别用
"${fileDirname}/*.cpp"这种通配——Windows 下 shell 不展开，Linux/macOS 也依赖 shell 类型；稳妥做法是列全源文件或用make/cmake -
"cwd"建议设为"${fileDirname}"（单文件）或"${workspaceFolder}"（多文件），避免头文件#include路径解析失败 -
"problemMatcher"用"$gcc"能正确高亮错误行，不配就只能靠肉眼扫终端输出
launch.json 的 program 路径必须与 tasks 输出一致
"program"字段不是“猜路径”，而是硬绑定。常见错误是 tasks 编译到a.out，launch 却写${workspaceFolder}/main，结果报错Cannot launch program '.../main': File not found.
- 检查
tasks.json中"args"里的-o参数输出路径，比如"-o", "${fileDirname}/main"，那launch.json的"program"就得严格写成"${fileDirname}/main" - Windows 用户注意路径分隔符：
${fileDirname}\main.exe，而不是/——VSCode 变量在 Windows 上自动转义，但手写斜杠会失效 -
"preLaunchTask"的值必须和tasks.json里某个任务的"label"完全一致（包括空格和大小写），否则点击 F5 时提示Could not find the task... - 如果程序需要读取 stdin 或调用 system() 启动子进程，把
"externalConsole"设为true，否则输入卡死或子进程找不到终端
跨平台路径变量要按系统语义理解
${workspaceFolder}、${fileDirname}这些不是字符串拼接模板，它们在不同系统上返回的路径格式不同，直接影响g++和gdb能否识别。
-
${fileDirname}在 Windows 返回C:projectsrc，在 Linux/macOS 返回/home/user/project/src；所以command里写g++就行，别写C:\mingw\bin\g++——让 PATH 解决可执行文件定位 -
"midebuggerpath"只在 Windows + MinGW 场景下需要显式指定（如"d:\mingw64\bin\gdb.exe"），Linux/macOS 一般不用配，系统 PATH 找得到就直接用 - Mac 用户若用 Xcode 自带工具链，
"type"仍填"cppdbg"，但"MIMode"应为"lldb"，且"setupCommands"里启用 pretty-printing 的命令是settings set target.max-string-summary-length 1024，不是 gdb 的-enable-pretty-printing
最容易被忽略的是：tasks.json里"group": {"kind": "build", "isDefault": true}这行。没有它，VSCode 就不知道该默认执行哪个任务，F5 时不会自动触发编译——你得手动 Ctrl+Shift+P → “Tasks: Run Build Task” 先跑一遍，再按 F5，流程就断了。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
