报错八成是launch.json中program等路径字段指向不存在的文件；需手动验证文件真实存在、cwd与路径匹配、tasks.json构建成功、字段名与调试器类型一致，并检查权限和转义。
这个报错八成不是调试器坏了，而是 launch.json 里某个路径字段指向了根本不存在的文件或目录——VS Code 不会自动纠错，只认你写的字面值。
检查 program 或 executable 是否真实存在
VS Code 调试器只看 program（C/C++）、executable（Cortex-Debug）或 program/module（Python）字段的值，不会补全、不会 fallback。
- 打开终端，cd 到
${workspaceFolder}，再手动执行ls -l ./bin/main（Linux/macOS）或dir .inmain.exe（Windows），确认文件真在那儿 - 别写
./main就完事——得确认cwd是${workspaceFolder}还是${workspaceFolder}/build，路径错一级就 404 - 嵌入式项目常见坑：
Cube_Text.elf写进配置，但实际生成的是Cube_Text.axf或Cube_Text_v2.elf，差一个字符就失败 - Windows 上反斜杠必须双写
"C:\project\main.exe"或统一用正斜杠"C:/project/main.exe"，混用会解析失败
验证 tasks.json 是否真生成了目标文件
点「开始调试」只是触发 preLaunchTask，它如果静默失败，你根本不知道构建压根没跑。
- 按
Ctrl+Shift+P→ 输入Tasks: Run Task→ 选你的构建任务（如build with g++），看终端是否真输出类似g++ -g -o ./bin/main main.cpp -
args必须拆成数组：["-g", "${file}", "-o", "./bin/main"]，写成["-g ${file} -o ./bin/main"]会被当做一个参数，编译器直接忽略后半截 - 多文件项目别只依赖
${file}，得用${fileDirname}/*.cpp或上 CMake，否则只编当前打开的 .cpp - 先在终端里跑
g++ --version或cmake --version，PATH 没配好，tasks.json再对也白搭
确认调试器类型与字段名完全匹配
硬套模板最危险：不同调试器字段名不同，变量展开规则也不一样。
- C/C++ 扩展（
type: "cppdbg"）用program；Cortex-Debug（type: "cortex-debug"）用executable；PHP 调试器用runtimeExecutable -
${workspaceFolder}安全，但./bin/main的“当前目录”取决于cwd字段，默认是${workspaceFolder}，不是.vscode目录，也不是你终端当前所在位置 - Python 用户注意：
python字段值是解释器路径（如/usr/bin/python3），不是脚本路径；module模式下填模块名（如"http.server"），不是"http.server.py" - Node.js 项目若用了 nvm/pnpm，
runtimeExecutable得填绝对路径，比如"${env:HOME}/.nvm/versions/node/v18.18.2/bin/node"
排查 Python debugpy 版本兼容性问题
Python ≤3.7 时，debugpy ≥1.6.0 会直接报 SyntaxError: invalid syntax，因为用了 / 参数分隔符（Python 3.8+ 才支持）。
- 终端运行
python --version，若 ≤3.7，执行pip install "debugpy（推荐 <code>1.5.1） - 装完后必须重启 VS Code，否则旧进程还在用缓存的 debugpy
- 如果装了 Debugpy Old 扩展，
launch.json中type必须显式写"debugpy-old"，不能留空、不能写"python"或"debugpy" - 右下角显示
Python 3.7.17≠ 调试能用——按Ctrl+Shift+P→Python: Select Interpreter，重新选一次当前虚拟环境里的python可执行文件
路径问题最常被当成“调试器坏了”，其实只是 VS Code 在安静地拒绝一个不存在的字符串。动手前先在终端里 ls 或 dir 一下，比反复重装扩展管用得多。
