能跑通helloworld.java不代表环境配对，根本原因是java.home未正确配置至jdk根目录、未安装完整extension pack for java、或未以文件夹形式打开项目；三者缺一不可。
能跑通 HelloWorld.java 不代表环境配对了，很多新手卡在“点了运行没反应”“提示找不到主类”“调试器连不上”，根本原因是 JDK 路径没被 VS Code 的 Java Language Server 正确识别——不是装了 JDK 就自动好使，必须让插件知道它在哪。
java.home 配置错路径，VS Code 就认不出 JDK
VS Code 的 Java 插件（比如 Language Support for Java™ by Red Hat）启动时会查 java.home，而不是系统 JAVA_HOME 环境变量。即使你在命令行里 java -version 和 javac -version 都正常，VS Code 仍可能报 Cannot resolve JDK 或状态栏不显示 Java 版本。
- 必须手动指定
java.home：打开设置（Ctrl+,），搜java.home→ 点击“在 settings.json 中编辑”，填入 JDK 根目录（不是bin子目录） - Windows 示例：
"java.home": "C:\Program Files\Eclipse Adoptium\jdk-17.0.9+9" - macOS 示例：
"java.home": "/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home" - Linux 示例：
"java.home": "/usr/lib/jvm/java-17-openjdk-amd64" - 路径里不能有中文、空格或特殊符号；反斜杠要双写（
\），斜杠（/）更安全
Extension Pack for Java 必须装全，少一个就断链
这个插件包是组合体，拆开装容易漏关键组件。比如只装了 Language Support for Java™ 却没装 Debugger for Java，你就点不了断点；没装 Project Manager for Java，新建项目时连 src/main/java 目录都不会自动生成。
- 直接搜安装
Extension Pack for Java（微软官方出品），别一个个手动凑 - 装完必须重启 VS Code——插件不是热加载，不重启语言服务起不来
- 装完后打开任意
.java文件，看右下角状态栏是否显示类似Java 17；没显示，说明java.home还没生效
项目结构不标准，Run 和 Debug 都会失败
VS Code 的 Java 运行/调试逻辑严重依赖项目结构。如果你只是新建一个 HelloWorld.java 文件扔在桌面，没有 src 目录、没有包声明、没用 Java: Create Java Project 向导，那 Ctrl+F5 很可能报 No main class found 或 Could not find or load main class。
- 正确做法：按
Ctrl+Shift+P→ 输入Java: Create Java Project→ 选No build tools→ 指定文件夹 → 自动生成src/main/java - 主类必须带包声明，例如
package com.example;，且文件路径要匹配（src/main/java/com/example/HelloWorld.java） - 不要手动建
.class文件或out目录——插件自己管编译输出，干扰反而触发缓存错误
最常被忽略的其实是“工作区”概念：VS Code 是以文件夹为单位读取 .vscode/settings.json 和项目结构的。直接双击打开单个 .java 文件，插件根本不会激活 Java 项目上下文——一定先打开文件夹，再新建文件。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
