最常见的原因是launch.json文件缺失或json格式错误；需通过debug: open launch.json自动创建标准模板，确保version为"0.2.0"、type与已安装调试扩展完全匹配，并用${file}或${workspacefolder}等变量正确配置program路径。
launch.json 文件缺失或格式错误
VSCode 调试启动失败，最常见的原因是 launch.json 根本不存在，或者存在但 JSON 语法不合法。VSCode 不会自动修复引号缺失、逗号遗漏或括号不匹配这类低级错误。
实操建议：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Debug: Open launch.json，让 VSCode 自动创建标准模板 - 不要手动新建空文件再粘贴配置——容易漏掉外层
{}或"configurations"数组结构 - 检查
"version"字段必须是"0.2.0"（字符串，带引号），不是0.2或"2.0" - 用 VSCode 内置校验：打开
launch.json后看右下角状态栏是否显示JSON；若显示Plain Text，点击切换语言模式为 JSON
调试器扩展未安装或 type 值不匹配
launch.json 中的 "type" 字段不是随便写的字符串，它必须和已安装的调试器扩展注册的类型完全一致。写错一个字母，比如 "pyton" 或 "nodejs"，就会报“无法找到调试器类型”。
实操建议：
- 确认已安装对应语言的官方调试扩展：Python 项目装
Python（Microsoft），C++ 项目装C/C++，前端调试 Chrome 必须装Debugger for Chrome -
"type"的合法值只能是扩展文档里明确声明的，例如："python"、"cppdbg"、"chrome"、"node"—— 没有"javascript"这种写法 - 如果刚装完扩展，重启 VSCode 再试；某些扩展（如 R Debugger）需额外执行命令面板中的
R: Install vscDebugger
路径配置错误导致 program 或 file 找不到
"program"（如 Python/Node）或 "file"（如 Chrome 调试）字段指向的路径一旦出错，调试器会静默失败，甚至不报具体错误。
实操建议：
- 优先使用变量：用
"${file}"表示当前打开的文件，"${workspaceFolder}"表示工作区根目录，避免硬编码绝对路径 - Chrome 调试中
"webRoot"必须指向能被浏览器正确解析静态资源的根路径；若项目是多级子目录（如/src/index.html），"webRoot"设为"${workspaceFolder}/src"更稳妥 - 检查文件是否存在：在终端里运行
ls -l "${workspaceFolder}/your-script.py"（Linux/macOS）或dir "%workspaceFolder%\script.js"（Windows），验证路径是否真能访问
Unity 和 R 等特殊环境的调试器已弃用或需额外包
Debugger for Unity 插件早在 2026 年前就停止维护，而 R 的 vscDebugger 包不是通过 install.packages() 直接装就能用的——它依赖 R 版本、UCRT 构建方式和本地编译工具链。
实操建议：
- Unity 项目直接卸载
Debugger for Unity，改用官方Unity插件，并确保 Unity 编辑器中已启用Visual Studio Editor包（2026.2+ 版本内置） - R 项目先在 R 控制台运行
R.version，确认ucrt: TRUE；若为FALSE，需从 CRAN 安装非 UCRT 版本的vscDebugger，否则必须从 GitHub 下载预编译包 - 所有语言调试前，先在命令面板运行对应扩展的验证命令，例如
CodeLLDB: Show Debugger Version或Python: Select Interpreter
最常被忽略的一点：VSCode 的调试行为高度依赖工作区（Workspace）而非单个文件夹。如果打开的是多根工作区（multi-root workspace），"${workspaceFolder}" 会失效，必须显式指定某一个根目录，或改用 "${workspaceFolder:project-name}"。
