首要排查 code 命令是否注册到 PATH：macOS/Linux 执行 Shell Command: Install 'code' command in PATH，Windows 重装时勾选 Add to PATH；验证用 which code 或 where code。
检查 code 命令是否在系统 PATH 中
VSCode 的终端中执行命令（如 python、node）失败，或点击“运行”无响应，第一排查点往往是 code 命令未正确注册到 shell 环境。Mac/Linux 下常因 VSCode 未通过菜单「Shell Command: Install 'code' command in PATH」安装；Windows 则可能因安装时未勾选「Add to PATH」。
- macOS：打开 VSCode →
Cmd+Shift+P→ 输入Shell Command: Install 'code' command in PATH并执行 - Linux：同上，或手动将
/usr/share/code/bin加入$PATH - Windows：重装 VSCode，安装向导中务必勾选
Add to PATH；已安装可进设置搜索shell integration开启 - 验证方式：终端重启后运行
which code（macOS/Linux）或where code（Windows），应返回有效路径
确认调试器插件与运行时版本匹配
比如用 Python 扩展调试 Python 3.12 项目，但插件仍为旧版（如 ms-python.python v2023.8），就可能报 Debug adapter process has terminated unexpectedly。Node.js 同理：新版本 V8 的 ESM 支持变化会影响 ms-vscode.node-debug2 或内置 Node 调试器行为。
- Python：检查
python.defaultInterpreterPath是否指向你实际使用的解释器（如/opt/homebrew/bin/python3.12），而非系统默认/usr/bin/python3 - Node.js：若项目含
"type": "module"，需确保launch.json中启用"runtimeArgs": ["--experimental-specifier-resolution=node"]（Node ≥14.18） - Java：
redhat.java插件要求 JDK 版本 ≥17（2023 年后主流版本），且java.home必须指向 JDK 根目录，不是 JRE - 插件更新后务必重启 VSCode，部分插件不支持热重载调试适配器
查看 DEBUG CONSOLE 和 OUTPUT 面板中的真实错误
用户常只看终端输出或报错弹窗，但真正关键信息藏在 OUTPUT 面板的特定通道里——比如 Python 插件会把 interpreter 检测日志打到 Python 通道，Node 调试器崩溃详情在 Debug 通道，而 DEBUG CONSOLE 显示的是调试会话内表达式求值结果，非启动错误源。
- 打开
OUTPUT面板（Ctrl+Shift+U/Cmd+Shift+U），下拉选择对应通道（如Python、Tasks、Extensions） - 常见线索：
Failed to launch debug adapter: spawn node ENOENT→node不在 PATH；ModuleNotFoundError: No module named 'debugpy'→ Python 插件未自动安装依赖，需手动运行python -m pip install debugpy -
DEBUG CONSOLE出现ReferenceError: require is not defined→ 当前调试模式为浏览器环境（web-browser类型），却尝试运行 Node.js 代码
禁用可疑插件快速定位冲突
某些插件会劫持终端初始化、覆盖 launch.json 解析逻辑，或与语言服务器发生竞态。典型如 Wallaby.js、Code Runner、Auto Rename Tag（极少数情况干扰 HTML 调试），或刚安装的 LSP 客户端。
- 启动 VSCode 时加
--disable-extensions参数：终端执行code --disable-extensions .，再试运行 - 若此时正常，说明是插件问题 → 进入
Ctrl+Shift+P→Developer: Show Running Extensions查看活跃扩展加载耗时 - 逐个禁用近期安装/高权限插件（尤其带「debug」「terminal」「language」关键词的），每次禁用后重启 VSCode 验证
- 注意：
Code Runner默认使用独立终端而非集成终端，其执行路径与launch.json无关，容易造成“能跑但不能断点”的错觉
环境变量继承、工作区设置覆盖、多根工作区下的 .vscode/settings.json 优先级，这些细节往往比插件兼容性更隐蔽。动手前先看 OUTPUT 面板里具体哪一行报错，比猜“是不是没装对”高效得多。
