VSCode Java配置中系统环境变量非必须但强烈建议配JAVA_HOME；Java扩展优先读取java.home设置或自动扫描标准JDK路径，故编辑器内可不依赖系统变量，但终端命令、Maven/Gradle等工具仍需正确环境变量对齐以避免版本冲突。
VSCode 配置 Java 时，系统环境变量不是必须的，但强烈建议配 JAVA_HOME；PATH 中加 %JAVA_HOME%\bin 可避免终端里 java/javac 命令失效。
为什么 VSCode 有时不依赖系统环境变量？
VSCode 的 Java 扩展（如 Extension Pack for Java）会优先读取设置里的 java.home，或自动扫描常见 JDK 安装路径（如 C:\Program Files\Java\、/Library/Java/JavaVirtualMachines/）。这意味着：即使没设 JAVA_HOME，只要 JDK 装在标准位置，插件大概率能“自己找到”。
但问题出在“不一致”——编辑器里用的是 JDK 17，终端里敲 mvn compile 却调用 JDK 8，这类冲突几乎都源于系统环境变量没对齐。
- 未配置
JAVA_HOME→ Maven/Gradle 插件、终端内命令、调试器可能各自选版本 - 只配了
PATH没配JAVA_HOME→ 多数构建工具（如 Maven）会报The JAVA_HOME environment variable is not defined correctly - VSCode 设置了
java.home，但终端没继承 → 点击代码上方Run成功，mvn test却失败
Windows 系统变量设置方法（含关键细节）
打开“系统属性 → 高级 → 环境变量”，在“系统变量”区域操作：
立即学习“Java免费学习笔记（深入）”；
- 新建变量名：
JAVA_HOME，变量值填 JDK 根目录（不是bin子目录），例如：C:\Program Files\Eclipse Adoptium\jdk-17.0.9.9-hotspot - 编辑
Path，新增两行：%JAVA_HOME%\bin和%JAVA_HOME%\jre\bin（后者在较新 JDK 中可能不存在，可跳过） -
不要手动添加
CLASSPATH—— 现代 Java 项目（尤其 Maven/Gradle）完全不需要它，加了反而干扰类加载
验证方式：新开一个 CMD（不是旧窗口），运行 echo %JAVA_HOME% 和 java -version。如果显示路径和版本号一致，说明生效。
macOS/Linux 下用 shell 配置的坑点
别直接改 /etc/profile，优先编辑当前用户 shell 配置文件（如 ~/.zshrc 或 ~/.bash_profile）：
- 写法必须是
export JAVA_HOME=/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home（注意结尾无/bin） -
export PATH=$JAVA_HOME/bin:$PATH——$JAVA_HOME/bin必须放在$PATH开头，否则可能被旧版 Java 覆盖 - 执行
source ~/.zshrc后，再开新终端验证；用which java看是否指向$JAVA_HOME/bin/java - 如果用的是 Homebrew 安装的 Temurin，路径可能是
/opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk/Contents/Home，别抄错
真正容易被忽略的是：VSCode 启动方式。从桌面图标或开始菜单启动的 VSCode，**不会自动加载 shell 的环境变量**（尤其是 macOS/Linux）。解决办法只有两个：从终端执行 code 命令启动，或在 VSCode 设置里显式填好 java.home 并勾选 Maven › Terminal: Use Java Home。否则，你看到的“配置成功”，可能只是编辑器单方面自洽而已。
