首要排查 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 显示的是调试会话内表达式求值结果，非启动错误源。
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 打开
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 面板里具体哪一行报错，比猜“是不是没装对”高效得多。
