VS Code 配置 Java 开发环境的关键是正确设置 java.home、安装 Extension Pack for Java 并确保 JDK 17+ 完整安装且无冲突；需验证编译、调试、依赖解析全流程。
VS Code 本身不是 Java IDE，但装对扩展、配好 JDK 路径后，它能胜任日常开发——关键不在“装多少”，而在 java.home 指向正确、Extension Pack for Java 启用到位、且没有残留的旧 JDK 冲突。
确认系统已安装 JDK 17+（非 JRE）
VS Code 的 Java 扩展不自带 JDK，必须提前手动安装。JDK 8 已被主流扩展弃用；JDK 17 是当前最稳妥的选择（LTS），JDK 21 也可用但部分插件可能有短暂适配延迟。
- 用
java -version和javac -version验证两者输出一致且 ≥ 17 - 注意：Windows 用户常误装 “JRE” 或 “Java SE Development Kit” 里的精简版；请从 Eclipse Temurin 或 jdk.java.net 下载完整 JDK
- macOS 用户若用 Homebrew 安装，执行
brew install temurin17后，JDK 路径通常是/opt/homebrew/opt/temurin17/libexec/openjdk.jdk - Linux 用户注意权限：确保当前用户对
$JAVA_HOME目录有读+执行权限，否则 VS Code 启动 Language Server 会静默失败
安装 Extension Pack for Java（不是单个“Java”扩展）
单独启用 Red Hat Java 扩展是不够的——它只是语言支持入口。真正起作用的是由多个官方扩展组成的捆绑包，缺一不可。
- 在 VS Code 扩展市场搜索
Extension Pack for Java，安装并启用整套（含Language Support for Java™、Debugger for Java、Test Runner for Java等） - 禁用任何第三方“Java Extension”或“Java IDE”类扩展，它们大概率与官方包冲突，导致
Java Projects视图空白或Run按钮不出现 - 安装后重启 VS Code，打开一个
.java文件，底部状态栏应显示Java 17（或你实际版本），否则说明 JDK 未识别
配置 java.home —— 90% 的问题出在这里
VS Code 不自动读取系统 JAVA_HOME 环境变量，必须显式配置。路径错误会导致项目加载失败、无代码补全、运行时报 Cannot resolve module 等。
立即学习“Java免费学习笔记（深入）”；
- 打开设置（
Ctrl+,/Cmd+,），搜索java.home - 点击
Edit in settings.json，添加（或修改）这一行："java.home": "/path/to/your/jdk-17.0.x"
（Windows 示例："java.home": "C:\Program Files\Eclipse Adoptium\jdk-17.0.2-hotspot"） - 路径必须精确到 JDK 根目录（含
bin、lib子目录），不能指向jre子目录，也不能带末尾斜杠 - 如果使用多个 JDK，可在工作区根目录建
.vscode/settings.json单独指定：{ "java.home": "../jdk-17" }，优先级高于全局设置
验证是否真能跑起来
别只看语法高亮——要验证编译、调试、依赖解析三个环节都通。
- 新建文件夹 → 用命令面板（
Ctrl+Shift+P）运行Java: Create Java Project→ 选no build tools快速生成结构 - 在
src下新建HelloWorld.java，写最简 main 方法，保存后观察左下角是否出现Building workspace...并完成 - 按
F5启动调试：若弹出“选择环境” → 选Java→ 自动生成.vscode/launch.json，然后断点能命中、控制台输出正常，才算闭环 - 常见卡点：
ClassNotFoundException多因outputPath被意外改写；Source not found提示则大概率是java.home指向了 JRE 或不完整 JDK
真正的难点从来不是“怎么点下一步”，而是 JDK 路径里多一个空格、少一个 bin、或者系统 PATH 里残留着旧版本 java.exe —— 这些细节不会报错，只会让整个 Java 视图灰掉、run 按钮消失、甚至不提示任何原因。
