最省事方式是用微软官方Coding Pack for Java一键安装包，含VS Code、JDK 21和全套插件，下载即用；手动配置仅适用于多JDK共存或需精确控制路径的场景。
VSCode 配置 Java 最省事的方式是用一键安装包；手动配置只在你需要多 JDK 版本共存、或已有特定 JDK 路径且不想重装时才值得做。
用 Coding Pack for Java 一键装完就能写代码
微软官方打包的 Coding Pack for Java 已预装：VS Code + 最新 LTS JDK（当前是 Java 21）+ Extension Pack for Java 全套插件。下载地址是 https://aka.ms/vscode-java-pack，Windows/macOS/Linux 都有对应版本。
- 装完直接打开 VS Code，新建
HelloWorld.java，按Ctrl+F5就能运行，不用调任何设置 - 它会自动把 JDK 装在用户目录下（比如 Windows 是
%USERPROFILE%AppDataLocalProgramsMicrosoft VS Codejdk-21），路径干净、不污染系统环境变量 - 如果你已装过 VS Code，它不会覆盖，而是新建一个独立实例，避免和你原有配置冲突
- 缺点：不能指定 JDK 版本（比如非要 Java 17），也不适合企业级项目中需要精确控制 JDK 路径的场景
手动配置时必须确认的三个硬性条件
手动配不是“装完 JDK + 插件”就完事，VS Code 的 Java 插件依赖三件事同时成立：
-
JAVA_HOME环境变量必须指向 JDK 根目录（不是bin子目录），且该路径下必须有lib/rt.jar或lib/modules（Java 9+） -
Path中必须包含%JAVA_HOME%in（Windows）或$JAVA_HOME/bin（macOS/Linux），否则终端里java -version和javac -version都会失败 - VS Code 必须装了
Extension Pack for Java，且插件启用后，在命令面板（Ctrl+Shift+P）里能搜到Java: Configure Java Runtime
漏掉任意一条，就会出现“找不到 JDK”“Language Server 启动失败”“运行按钮灰掉”等现象。
立即学习“Java免费学习笔记（深入）”；
java.home 设置错路径会导致哪些具体问题
java.home 是 VS Code 内部 Java 插件读取 JDK 的唯一依据，它不看系统 JAVA_HOME，也不走 Path。设错后表现很隐蔽：
- 代码补全失效、
Ctrl+Click进不去 JDK 源码（因为 Language Server 拿不到src.zip） - 调试时断点不生效，或报错
Cannot find JVM in java.home - 项目里如果有
module-info.java，编译直接失败，提示module not found - Windows 用户最容易填错：路径里用了正斜杠
/或没转义反斜杠，正确写法是"java.home": "C:\Program Files\Java\jdk-21" - macOS/Linux 用户注意：
/Library/Java/JavaVirtualMachines/下的路径要进到Contents/Home，不能只写到jdk-21.jdk
多 JDK 版本切换的实际操作方式
如果你同时需要 Java 17（兼容老项目）和 Java 21（新特性），手动配置反而更灵活：
- 在全局
settings.json里不设java.home，让插件自动探测系统 PATH 中第一个可用 JDK - 在具体项目根目录下建
.vscode/settings.json，单独指定："java.home": "/usr/lib/jvm/java-17-openjdk-amd64"
- 或者用命令面板执行
Java: Configure Java Runtime，在弹出界面里勾选已识别的多个 JDK，设为“Workspace JDK” - 注意：Maven 项目还受
pom.xml中<maven.compiler.source>控制，VS Code 的java.home只影响编辑器功能，不改变 Maven 编译目标
真正容易被忽略的是：JDK 路径一旦写死在工作区配置里，换机器或共享项目时，别人打开就会立刻报错——所以团队协作中，最好用 SDKMAN! 或 jEnv 管理 JDK，再配合 java.home 动态指向 ~/.sdkman/candidates/java/current 这类稳定别名路径。
