vs code不校验program路径真实性，只按字面值读取；路径错一个字符、大小写不符或cwd不匹配均导致“无法启动调试器”或静默失败，需手动在终端验证文件是否存在。
launch.json 中 program 路径是否真实存在
VS Code 不校验 program 字段指向的文件是否存在，只按字符串字面值去读取——路径错一个字符、少一级目录、大小写不一致，都会直接报 “无法启动调试器” 或静默失败。
验证方法很简单：打开终端，cd ${workspaceFolder}，再执行：
- Linux/macOS：
ls -l ./bin/main（把./bin/main换成你program里的实际路径） - Windows：
dir .inmain.exe或dir "binmain.exe"
常见坑：
-
cwd设为${workspaceFolder}/build，但program写./main→ 实际查找路径是build/./main - 嵌入式项目配置了
Cube_Text.elf，但实际生成的是Cube_Text.axf或Cube_Text_v2.elf - Windows 上混用斜杠：
C:projectmain.exe会被解析成转义序列，必须双反斜杠"C:\project\main.exe"或统一正斜杠"C:/project/main.exe"
调试器类型与字段名是否严格匹配
不同调试器对配置字段名要求完全不同，硬套模板必出错。字段名错、变量展开规则错，调试器根本不会加载。
关键对应关系：
- C/C++ 扩展（
type: "cppdbg"）→ 必须用program - Cortex-Debug（
type: "cortex-debug"）→ 必须用executable - Python 调试器 → 用
module或program，且依赖选中的解释器，不是靠python.defaultInterpreterPath手动填 - Node.js →
runtimeExecutable必须是绝对路径，如/usr/local/bin/node；只写"node"很可能找不到
检查方式：按 Ctrl+Shift+P → 输入 Debug: Open launch.json，确认 type 和对应字段完全一致，别漏掉引号或拼错小写字母。
扩展是否因版本不兼容被自动禁用
VS Code 更新后，插件常因 package.json 中 "engines.vscode" 声明不匹配而被静默禁用——界面仍显示“已启用”，但实际没加载，F5 点下去毫无反应。
排查步骤：
- 按
Ctrl+Shift+P→ 输入Extensions: Show Installed Extensions→ 右上角筛选器选Disabled - 打开开发者工具（
Help → Toggle Developer Tools），看 Console 里有没有类似Extension 'ms-python.python' is not compatible with Code '1.118.0'的红字 - 插件卡片右上角齿轮菜单若显示
Disable (For All Workspaces)，但你没点过，基本就是被自动禁用了
修复建议优先级：
- 扩展面板里点 ⋯ →
Install Another Version…，选一个和你当前code --version匹配的历史版（如 1.118 对应 Python 插件 2026.6.x） - 若该选项灰显，说明市场没收录对应版本，需手动下载 .vsix 并用
code --install-extension ./xxx.vsix安装
tasks.json 是否真生成了目标文件
preLaunchTask 是个“黑盒”：它失败时 VS Code 不报错，只让调试卡在“准备中”。你以为构建成功了，其实 g++ 根本没跑，或者编译输出路径和 program 对不上。
务必手动验证：
- 按
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再对也白搭
最易被忽略的一点：调试器启动时不会继承你终端里激活的虚拟环境或 PATH，它只认 launch.json 里写的绝对路径，或 VS Code 当前选中的解释器——这点在 Python 和 Node.js 场景下尤其致命。
