VSCode需安装Java Extension Pack并正确配置java.home路径才能支持Java开发。必须确保JDK路径一致、扩展完整、Maven项目手动导入，否则将导致编译、调试或项目加载失败。
VSCode 本身不原生支持 Java，必须通过扩展和正确配置 JDK 才能完成编译、调试、智能提示等关键操作。没配对 JDK 路径或装错扩展，java 命令能运行也不代表 VSCode 能识别项目。
安装 Java 扩展包组合（不是只装一个）
单独安装 “Java Extension Pack” 是最稳妥的选择，它自动包含五个核心扩展：Language Support for Java、Debugger for Java、Test Runner for Java、Project Manager for Java、Visual Studio Code Extensions for Java。如果手动拼凑，容易漏掉 Debugger for Java 导致 F5 启动失败，或缺少 Project Manager 导致 Maven 项目无法正确加载。
安装后重启 VSCode，打开一个 .java 文件，状态栏右下角应显示 Java 版本号（如 “17”），否则说明扩展未生效。
正确设置 JAVA_HOME 和 vscode 的 java.home
JAVA_HOME 环境变量影响终端中 javac 和 java 命令，但 VSCode 的 Java 扩展默认不读取它；它依赖自己的配置项 java.home。两者路径必须指向同一份 JDK（推荐使用 JDK 17+，JDK 21 也已稳定支持），否则会出现“编译用 JDK 17，运行时却调用 JRE 8”的错乱。
立即学习“Java免费学习笔记（深入）”；
- 先确认 JDK 安装路径：在终端运行
which java或where java（Windows），再执行readlink -f $(which java)（Linux/macOS）反查到jdk-17.0.x根目录 - 在 VSCode 设置中搜索
java.home，填入完整路径，例如：/Library/Java/JavaVirtualMachines/jdk-17.0.2.jdk/Contents/Home（macOS）、C:\Program Files\Java\jdk-17.0.2（Windows） - 不要填到
bin目录下，也不能填 JRE 路径 —— 否则javac不可用，扩展报错 “The java.home variable is not defined”
Maven/Gradle 项目导入失败的常见原因
新建空文件夹并放一个 pom.xml，VSCode 并不会自动识别为 Java 项目。需要等待右下角弹出 “Import project?” 提示并点击，或手动触发命令面板（Ctrl+Shift+P / Cmd+Shift+P）运行 Java: Import Projects。
如果始终不弹提示或导入后类路径为空：
- 检查
pom.xml是否有语法错误（比如<dependency>缺闭合标签） - 确认
maven命令在终端可用，且版本 ≥ 3.6.3（旧版可能触发UnsupportedClassVersionError） - 关闭
java.configuration.updateBuildConfiguration的自动模式，改为interactive，避免静默失败 - 删除项目根目录下的
.vscode/和.project（如有），再重试导入
真正卡住的地方往往不是“怎么装”，而是 JDK 路径在系统、终端、VSCode 三处不一致，或者扩展没拉取完就强行打开项目。建议第一次配置时全程用终端验证 java -version 和 javac -version，再进 VSCode 看状态栏和输出面板里的 Java Language Server 日志。
