VSCode需安装Extension Pack for Java才能调试Java，PHP调试则需手动配置Xdebug并配合PHP Debug扩展；两者均依赖正确路径配置和自动生成的launch.json。
VSCode里没有Java调试器？装 Extension Pack for Java 最省事
vscode本身不带java运行时或调试能力，必须靠扩展补全。直接搜“java”会看到一堆插件，但官方推荐的 extension pack for java 是唯一需要装的——它自动包含 language support for java、debugger for java、test runner for java 等核心组件，版本对齐有保障。
常见错误是只装了 Java Extension Pack（旧名，已弃用）或单独装 Debugger for Java 却漏掉语言支持，结果断点不生效、类路径报红。装完后打开一个 .java 文件，底部状态栏应显示“Java”和JDK版本；按 F5 启动调试前，确保项目根目录有 pom.xml 或 build.gradle，否则调试器可能找不到主类。
PHP调试要用Xdebug，但VSCode只负责连接，不提供Xdebug本身
PHP Debug 扩展（由 Felix Becker 维护）只是个客户端，它通过 DBGp 协议和本地运行的 Xdebug 通信。这意味着你必须在系统 PHP 环境中手动启用 Xdebug，并配置好 php.ini，VSCode 才能连上。
容易踩的坑包括：
- Xdebug 3.x 默认关闭远程调试，需显式设置
xdebug.mode=debug和xdebug.client_host=127.0.0.1 - VSCode 的
launch.json中pathMappings必须严格匹配服务器路径与本地文件路径，比如用 Docker 时常见"\/var\/www\/html\/": "${workspaceFolder}\/" - 浏览器没装 Xdebug Helper 插件，或没点击“Debug”按钮触发调试会话，VSCode 就一直等不到连接
调试配置别硬写，用 VSCode 自动生成的 launch.json
Java 和 PHP 都支持从命令面板（Ctrl+Shift+P）运行 Debug: Open launch.json 自动生成配置。Java 会识别 Maven/Gradle 项目结构，给出 Launch Current File 或 Debug Tests 模板；PHP 则默认生成监听模式（listen for Xdebug），适合 CLI 或 Web 场景。
立即学习“PHP免费学习笔记（深入）”；
注意两点：
- Java 的
mainClass字段必须指向含public static void main(String[] args)的类，不能只写类名不带包路径（如com.example.App，不是App） - PHP 的
port要和xdebug.client_port一致，默认是9003（Xdebug 3+），不是旧版的9000
启动调试前，先确认 JDK 或 PHP CLI 路径被 VSCode 正确识别
VSCode 不读系统环境变量，而是依赖扩展自己找运行时。Java 扩展会扫描 JAVA_HOME、PATH、常见安装路径（如 /usr/lib/jvm/、C:\Program Files\Java\），但如果你装了多个 JDK 版本，可能选错——在命令面板执行 Java: Configure Java Runtime 可手动指定。
PHP 同理：PHP Debug 扩展默认调用 php 命令，如果终端里 which php 返回的是 Homebrew 安装的路径，但 VSCode 终端用的是 zsh 配置而 GUI 启动用的是 bash，就可能找不到。解决方法是在 VSCode 设置里搜 php.executablePath，填绝对路径，比如 /opt/homebrew/bin/php。
路径不对最直接的表现是：按 F5 后弹出“Cannot find runtime 'php'”或 Java 调试器卡在“Starting the Java Debugger…”不动。
