VSCode需手动配置JDK路径并安装Extension Pack for Java扩展，确保java.home指向完整JDK根目录（非JRE或bin子目录），且launch.json中type为"java"、mainClass为完整类名。
VSCode 本身不内置 Java 支持，必须手动配置 JDK 路径并安装关键扩展，否则连 java 命令识别、语法高亮、代码补全都会失败。
确认系统已安装 JDK，且 java -version 和 javac -version 均能正常输出
这是最常被跳过的前提。VSCode 的 Java 扩展不会帮你装 JDK，只读取已有环境：
- 推荐使用 JDK 17 或 JDK 21（LTS 版本），避免用 JRE 或仅含 JRE 的“Java 运行环境”
- Windows 用户注意：不要只依赖
PATH中的java.exe，javac.exe必须存在且可执行，否则编译报Command 'Java: Compile' resulted in an error -
macOS/Linux 用户若用 SDKMAN 安装，确保
java和javac指向同一 JDK 根目录（可用which java和readlink -f $(which javac)验证）
安装 Extension Pack for Java，并在设置中指定 java.home
官方扩展包（ID：redhat.java）是必须的，它打包了语言服务器、调试器、Maven 集成等核心能力：
- 安装后必须手动配置
java.home：打开 VSCode 设置（Ctrl+,），搜索java.home，填入 JDK 根目录（如/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home或C:\Program Files\Java\jdk-17.0.1），不是bin子目录 - 如果项目用 Maven，还需检查
java.configuration.maven.userSettings是否指向正确的settings.xml（尤其在公司内网需代理或私有仓库时） - 多个 JDK 共存时，
java.home只影响当前工作区；可通过.vscode/settings.json文件为项目单独锁定版本
运行和调试前，确认 launch.json 使用的是 java 类型而非 node 或空模板
新建 Java 类后点右上角 ▶️ 运行，VSCode 会自动生成 .vscode/launch.json —— 但默认可能选错类型，导致 No java runtime is found 或直接报错退出：
立即学习“Java免费学习笔记（深入）”；
- 确保
configurations[].type是"java"，不是"pwa-node"或未填写 -
configurations[].mainClass必须显式指定完整类名（如"com.example.HelloWorld"），不能只写文件名 - 如果类在默认包（无
package声明），mainClass就是类名本身；但强烈建议始终用命名包，避免路径解析混乱
真正容易卡住的地方，往往不是“没装对扩展”，而是 java.home 指向了一个只有 JRE 的路径，或者 launch.json 里 mainClass 写成了 HelloWorld.java 而不是 HelloWorld。
