${fileDirname} 总指向当前打开的 .cpp 文件所在目录而非项目根或构建目录，导致断点失效、程序找不到等问题；应优先使用 ${workspaceFolder}/build/xxx，统一 cwd 与 program 路径，并严格匹配 preLaunchTask label。
program 字段里 ${fileDirname} 为什么总指向错目录？
它只取当前打开的 .cpp 文件所在目录，不是项目根目录，也不是构建输出目录。你在 src/utils/helper.cpp 里按 F5，${fileDirname} 就是 src/utils，而不是 build 或 bin。如果可执行文件实际在 build/app，那断点永远不生效。
常见错误现象：断点显示空心圆、调试器报 program does not exist、GDB 启动后立刻退出。
- 确认你当前编辑的源文件路径，再推导
${fileDirname}实际展开值（可在 launch.json 中临时写死一个 log 输出验证） - 优先改用
${workspaceFolder}+ 固定子路径，比如"${workspaceFolder}/build/myapp" - 若必须依赖当前文件位置，确保所有源码都在同一级构建输出目录下——这通常不现实，慎用
cwd 配置错导致程序找不到动态库或配置文件
cwd 决定程序运行时的当前工作目录，直接影响 fopen("config.json", "r") 这类相对路径操作。很多 C++ 项目假设自己从 build 目录启动，但 cwd 默认是 ${workspaceFolder}，结果一运行就报 “No such file or directory”。
使用场景：程序加载资源、读取命令行参数中的相对路径、调用 system() 执行子命令。
- 不要让
cwd和program路径混用：比如program指向build/app，cwd却设为${workspaceFolder}—— 程序启动后 pwd 是项目根，但二进制在 build 下 - 推荐统一设为
"${workspaceFolder}/build"（或对应输出目录），和program的父目录一致 - Windows 下注意反斜杠转义问题：
"${workspaceFolder}\build"不安全，一律用正斜杠
preLaunchTask 的 label 和 tasks.json 中的 label 大小写/空格全匹配
VSCode 匹配 preLaunchTask 时是严格字符串相等，不忽略空格、不忽略大小写、不自动 trim。你在 tasks.json 里写的是 "label": "build-debug"，launch.json 里写 "preLaunchTask": "build debug"，就会报 “Could not find the task”。
容易被忽略的地方：复制粘贴时带了不可见 Unicode 空格（如 ），或用了中文全角空格。
- 打开 tasks.json，把光标放在 label 值里，左右方向键逐字符移动，确认没有多余空格
- 在 launch.json 中右键点击
preLaunchTask字符串 → “Go to Definition”，如果跳不到 tasks.json 对应项，说明没匹配上 - 建议 label 全部用英文小写+短横线，例如
"gpp-build-debug"，避免任何歧义
CMake Tools 插件启用后 launch.json 的 args 自动失效
只要你点了 CMake Tools 工具栏里的 ▶️ Debug 按钮，VSCode 就会绕过 launch.json 的 args 字段，哪怕你配置了也完全不读。这是插件设计机制，不是 bug。
典型表现：launch.json 里写了 "args": ["--verbose"]，但程序 argv[1] 始终为空；调试控制台看不到参数传入日志。
- 停用 CMake Tools 插件，改用纯 cppdbg 调试（直接 F5）——这时
args生效，但需手动保证 build 完成 - 若必须用 CMake Tools，请在
.vscode/settings.json中写："cmake.debugConfig": { "args": ["--verbose"] } - 注意：settings.json 中的
args会覆盖 launch.json 同名字段，且支持变量如"${workspaceFolder}/data"
program 展开后的绝对路径、确认 cwd 是否与程序预期一致、用字符串精确匹配替代“差不多就行”的心理，这三个动作做完，90% 的路径失效问题就消失了。 
