必须手动安装JDK 17/21并配置java.home路径，否则VSCode无法编译、运行或调试Java；需下载完整JDK（非JRE），验证java/javac版本一致，再在settings.json中显式设置java.home指向JDK根目录，重启后确认状态栏显示JDK版本。
VSCode 本身不自带 Java 运行环境，必须手动安装 JDK 并正确配置 java.home，否则连最基础的 javac 编译、java 运行、调试器启动都会失败。
下载并安装 JDK（推荐 JDK 17 或 JDK 21）
别用系统自带的 OpenJDK（如 macOS 的 /usr/bin/java），它通常没带 javac 或调试支持。直接去官方渠道下载完整 JDK：
- Windows/macOS/Linux 都推荐从 Eclipse Temurin 下载
jdk-17.0.12+7或jdk-21.0.3+9（LTS 版本更稳） - 安装后记下完整路径：Windows 类似
C:Program FilesEclipse Adoptiumjdk-17.0.12+7，macOS 类似/Library/Java/JavaVirtualMachines/jdk-17.0.12+7.jdk/Contents/Home - 安装完终端执行
java -version和javac -version必须都返回版本号，缺一个就说明装的是 JRE 或路径没生效
在 VSCode 中设置 java.home（关键一步）
VSCode 的 Java 插件（如 redhat.java）不会自动识别系统 JDK，必须显式指定。不配这个，插件会反复提示“Cannot resolve JDK”或卡在 “Loading Java Projects…”。
- 打开 VSCode 设置（
Ctrl+,或Cmd+,），搜索java.home - 点击 “Edit in settings.json”，添加一行：
"java.home": "/Library/Java/JavaVirtualMachines/jdk-17.0.12+7.jdk/Contents/Home"
（Windows 路径用双反斜杠或正斜杠均可，如"C:\Program Files\Eclipse Adoptium\jdk-17.0.12+7"） - 改完保存，重启 VSCode —— 不重启，插件仍读旧配置
- 验证：新建
.java文件，输入public class Test {，看左下角是否显示 JDK 版本；再按Ctrl+Shift+P输入Java: Configure Classpath，能正常打开即成功
安装必要插件并验证运行流程
只装 JDK 不够，VSCode 需要语言服务和运行支持：
立即学习“Java免费学习笔记（深入）”；
- 必装插件：
redhat.java（核心语言支持）、vscjava.vscode-java-debug（调试）、vscjava.vscode-java-test（可选，跑 JUnit） - 新建文件夹 → 新建
Hello.java→ 写最简代码：public class Hello { public static void main(String[] args) { System.out.println("OK"); } } - 右键选择
Run Java（不是Run Code插件！），输出面板应打印OK；若报错Error: Could not find or load main class Hello，大概率是没设java.home或文件名/类名不一致 - 注意：不要依赖
code-runner插件来跑 Java，它默认不读java.home，容易路径混乱
常见错误与绕不开的坑
零基础最容易卡在这几个地方：
-
java命令可用但 VSCode 里报 “The java.home variable is not set”：说明系统 PATH 有 JDK，但 VSCode 没继承该环境 —— 必须手动配java.home，不能指望自动发现 - 装了多个 JDK（比如同时有 JDK 8 和 JDK 17），
java -version显示 17，但 VSCode 仍用 8：检查java.home是否指向了旧路径，或项目根目录下有.vscode/settings.json覆盖了全局设置 - macOS 上从官网下载的 JDK 21 安装后路径含空格（如
Home Folder），导致 VSCode 启动失败：重装 Temurin 版本，路径天然无空格 - Windows 用户用 PowerShell 启动 VSCode（
code .），但 JDK 是在 CMD 里配的 PATH：PowerShell 不读 CMD 的 PATH，建议统一用系统级环境变量，或直接配java.home
真正卡住人的，往往不是“会不会写 Java”，而是 java.home 指向了一个不存在的路径，或者 VSCode 根本没读到它 —— 每次出问题，先打开设置搜 java.home，再打开终端敲两遍 which java 和 ls -la 看路径是否存在，比重装十遍都管用。
