VS Code配置Java必须手动指定java.home指向真实JDK，仅装插件不配路径会导致“Cannot resolve class”等报错；需验证java -version和javac -version均有效，且java.home路径正确、无空格或jre误引。
VSCode 本身不内置 Java 支持，必须靠 java.home 指向一个真实、可用的 JDK 才能启动语言服务；光装插件、不配 JAVA_HOME 或 java.home，90% 的报错（比如“Cannot resolve class”“No Java runtime found”）都源于此。
确认 JDK 已被系统识别，不是只装了 JRE
打开终端（cmd/PowerShell/Terminal），执行：
java -version
如果返回类似 java version "17.0.2"，说明运行时存在；但还不够——你还需要确认 javac 可用：
javac -version
若提示“不是内部或外部命令”，说明安装的是 JRE（仅运行环境），不是 JDK（含编译器）。此时必须重装 JDK，例如从 Eclipse Temurin 或 Oracle JDK 17 LTS 下载完整 JDK。Windows 用户注意：安装时勾选“Add to PATH”或手动配置 JAVA_HOME 系统变量，值为 JDK 根目录（如 C:Program FilesJavajdk-17.0.2），而非其下的 bin 子目录。
立即学习“Java免费学习笔记（深入）”；
在 VSCode 中显式设置 java.home，不要依赖自动探测
VSCode 的 Java 插件（Language Support for Java™ by Red Hat）会尝试扫描系统 PATH 查找 JDK，但容易误判、漏判，尤其多 JDK 共存或路径含空格/中文时。最稳做法是手动指定：
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 按
Ctrl+Shift+P（macOS 为Cmd+Shift+P），输入Preferences: Open Settings (JSON) - 在
settings.json中添加一行："java.home": "C:\Program Files\Java\jdk-17.0.2"（Windows 路径用双反斜杠或正斜杠均可；macOS/Linux 用正斜杠，如/Library/Java/JavaVirtualMachines/jdk-17.0.2.jdk/Contents/Home） - 保存后重启 VSCode 窗口（不是仅重载窗口），观察左下角状态栏是否出现 Java 版本号
⚠️ 注意：java.jdt.ls.java.home 是旧版配置项，已弃用；新版统一用 java.home。若同时设了 JAVA_HOME 系统变量和 java.home，以 java.home 为准。
验证 Java 扩展是否真正加载成功
装完 Java Extension Pack 后，别急着写代码——先看三个关键信号：
- 左侧活动栏出现
Java Projects视图（图标为咖啡杯） - 新建
.java文件后，编辑器左上角出现 “Run” 和 “Debug” 按钮（非灰色禁用状态） - 右键点击
public static void main方法，菜单中出现Run Java和Debug Java选项
如果任一缺失，大概率是 java.home 路径错误、JDK 权限不足（如 macOS 上未授权全盘访问）、或插件被其他扩展干扰。此时可打开 VSCode 的 Output 面板（Ctrl+Shift+U），选择 Java 日志通道，查看具体报错，常见如 Failed to launch JDT Language Server: Error: ENOENT，即路径根本不存在。
项目级 JDK 切换比全局设置更安全
如果你同时维护 Java 8（老项目）和 Java 17（新项目），硬编码 java.home 在全局 settings.json 里会互相冲突。正确做法是：在每个项目根目录下建 .vscode/settings.json，只写该项目专用配置：
{
"java.home": "/opt/jdk8"
}
这样 VSCode 会优先读取工作区配置，覆盖用户级设置。配合 Java: Configure Java Runtime 命令（Ctrl+Shift+P 输入调出），还能图形化管理多个已知 JDK，但该命令只是帮你生成配置，最终仍落回 java.home 字段。
真正卡住人的从来不是“怎么点开插件市场”，而是 JDK 路径里那个没被注意到的空格、那个指向 jre 目录的错误引用、或者那个被 IDE 自动忽略的权限弹窗——这些细节不手动验证，就永远在“明明装了却跑不起来”的循环里打转。
