VS Code配Java必须手动配置JAVA_HOME指向JDK根目录而非JRE，因Java插件依赖该路径下的javac和jrt-fs.jar等文件；若指向JRE或路径错误，将导致红波浪线、运行按钮灰掉等90%报错。
VS Code 配 Java 不是装个插件就完事——JAVA_HOME 没配对，90% 的报错（红波浪线、The JAVA_HOME environment variable is not defined correctly、运行按钮灰掉）都出在这一步。
为什么 JAVA_HOME 必须手动配，且不能指向 JRE
VS Code 的 Java 插件（比如 Language Support for Java™ by Red Hat）启动时会主动读取 JAVA_HOME，然后从该路径下找 bin/javac 和 lib/jrt-fs.jar 等关键文件。如果它指向的是 JRE（如 C:Program FilesJavajre1.8.0_301），就会找不到 javac，直接报错“JDK not found”。JDK 11+ 已不再自带独立 JRE，所以别再尝试用 jlink 手动造 jre 目录——插件不认这个。
- Windows：新建系统变量
JAVA_HOME，值必须是 JDK 根目录（如C:Program FilesEclipse Adoptiumjdk-17.0.9+9），不是.../bin，也不是.../jre - macOS/Linux：在
~/.zshrc里写export JAVA_HOME=$(/usr/libexec/java_home -v17)（推荐），比硬编码路径更可靠 - 验证命令必须同时成功：
java -version和javac -version；只跑通前者说明你配的仍是 JRE
java.home 设置和 java.configuration.runtimes 的区别
java.home 是 VS Code 插件的“默认 JDK”，影响语法检查、自动补全、项目解析；而 java.configuration.runtimes 是给多版本项目准备的运行时列表，比如你同时有 Java 8 和 Java 17 的 Maven 子模块。新手只需配好 java.home，否则打开 .java 文件就是满屏红色波浪线。
- 路径中反斜杠要双写：
"java.home": "C:\Program Files\Eclipse Adoptium\jdk-17.0.9+9" - 不要用中文路径或带空格路径（如
C:Program Files...在旧版插件里可能解析失败），可改用短路径名（C:Progra~1...）或重装到C:jdk17 - 配完必须重启 VS Code，热重载不生效；改了
settings.json后看右下角是否弹出“Java language server restarted”提示
Extension Pack for Java 安装后仍报“Cannot resolve class”
这不是插件没装好，而是项目结构没被识别。VS Code 的 Java 支持依赖标准目录约定（尤其是 Maven/Gradle 项目），裸建一个 .java 文件放在空白文件夹里，插件根本不会把它当 Java 项目处理。
立即学习“Java免费学习笔记（深入）”；
- 正确做法：按
Ctrl+Shift+P→ 输入Java: Create Java Project→ 选Maven或No build tools；后者会自动生成src/main/java目录 - 如果已有代码，确保
pom.xml或build.gradle在根目录，且 VS Code 是通过File → Open Folder打开整个项目文件夹，不是单个文件 - 常见陷阱：把
HelloWorld.java直接丢在桌面，然后用 VS Code 打开这个文件——此时插件只当它是普通文本，不启用 Java 语言服务
运行按钮灰掉 / Run Without Debugging 不可用
VS Code 的绿色三角形按钮只对“可执行类”响应：即含有 public static void main(String[] args) 方法，且该类被正确编译为 .class 文件（或由构建工具管理）。它不支持直接运行未编译的源码，也不支持非 main 方法。
- 确认类名和文件名完全一致（包括大小写），
HelloWorld.java里必须是public class HelloWorld - 如果是 Maven 项目，先确保
pom.xml中<packaging>jar</packaging>且有<build>...</build>块，否则插件无法推导主类 - 终端里手动试：
javac src/main/java/HelloWorld.java && java -cp src/main/java HelloWorld；成功了但 VS Code 按钮仍灰，大概率是项目没被识别为 Java 项目（见上一条）
最易被忽略的一点：所有配置（环境变量、settings.json、项目结构）必须全部到位，缺一不可。VS Code 不会告诉你“差哪一步”，只会静默失效。建议每配完一项，就用对应命令验证一次，而不是堆完所有步骤再统一测试。
