断点不生效主因是缺失-g编译参数或调试器未就位；需确保g++/gdb已安装并配置PATH，tasks.json中显式添加-g，launch.json的program与preLaunchTask路径严格匹配，修改代码后必须手动重建二进制。
必须先有带 -g 的可执行文件，否则断点永远不生效——这不是 VSCode 的问题，是调试器根本读不到符号信息。
确认编译器和调试器已就位
VSCode 本身不提供 g++ 或 gdb，它只是调用系统命令。如果终端里运行 g++ --version 或 gdb --version 报错或无输出，后续所有配置都白搭。
- Windows 用户：推荐用 winlibs 一键安装 MinGW-w64，勾选 “Add to PATH”；别只解压不配环境变量
- macOS 用户：
brew install gcc后，g++默认指向clang++，得显式用g++-13（版本号按实际输出调整），且编译时必须加-g - Linux 用户：用
sudo apt install g++ gdb即可，但注意 Ubuntu 22.04+ 默认装的是gdb而非gdb-multiarch，调试交叉编译目标需另装
tasks.json 必须生成带调试信息的二进制
VSCode 不会自动帮你加 -g。哪怕你写了 g++ main.cpp -o main，没 -g 就没法断点。手动写 tasks.json 是最可控的方式。
- 按
Ctrl+Shift+P→ 输入Tasks: Configure Task→ 选Others - 替换内容为（以单文件为例）：
{ "version": "2.0.0", "tasks": [ { "type": "shell", "label": "g++ build active file", "command": "/usr/bin/g++", "args": [ "-g", "-std=c++17", "${file}", "-o", "${fileDirname}/${fileBasenameNoExtension}" ], "options": { "cwd": "${fileDirname}" }, "problemMatcher": ["$gcc"], "group": "build" } ] } - 关键点：
-g不能少；"group": "build"让它能被launch.json的preLaunchTask正确识别；路径中避免中文、空格、符号
launch.json 的 program 和 preLaunchTask 必须严格对齐
断点灰色、提示 “Source not available”、F5 后直接退出——八成是 program 指向的文件根本不存在，或不是刚编译出来的那个。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
立即学习“C++免费学习笔记（深入）”；
-
"program"填的是**绝对路径或相对于工作区根目录的路径**，例如"./main"或"${workspaceFolder}/build/main"，不能写成"main"（当前目录不可靠） -
"preLaunchTask"必须和tasks.json里"label"完全一致，大小写、空格都不能差，比如"g++ build active file"≠"g++ build" - 如果你用 CMake Tools 插件，
cmake.buildDirectory配置值（如"build"）要和program中的路径层级匹配，否则 build 出来的东西不在你指的地方
改代码后断点失效？不是 bug，是预期行为
VSCode 从不自动 rebuild，也不在 restart 调试会话时重新加载符号表。函数签名变了、逻辑重写了，旧二进制里的地址映射就失效了。
- 改完代码 → 必须手动触发构建：按
Ctrl+Shift+B，或终端里跑cmake --build build - 再按
F5启动，不是Ctrl+Shift+F5（那是 restart，不 reload 二进制） - 如果函数参数变了、加了模板特化、内联被取消……哪怕只改一行，也得 stop → rebuild → start，跳过任何一步都可能断点飘移或失效
最容易被忽略的一点：launch.json 里 "externalConsole" 设为 true 时，控制台窗口一闪而过，看起来像没运行；设为 false 才能在 VSCode 内置终端看到输出——但这不影响断点本身，只影响你能不能看到 printf 或 std::cout。
