VS Code 本身不“安装 Java 插件”——它靠扩展（Extension）提供 Java 支持，而核心前提是本地已装好 JDK，否则所有插件都只是摆设。
确认 JDK 已正确安装并被识别
VS Code 的 Java 扩展（如 redhat.java）启动时会主动查找系统 PATH 中的 java 和 javac，找不到就直接报错或降级为纯文本编辑。
- 在终端运行
java -version和javac -version，必须输出版本号（如17.0.1），不能是“command not found” - Windows 用户注意：JDK 安装后常漏配
JAVA_HOME环境变量，VS Code 不读注册表，只认JAVA_HOME或 PATH 里的可执行文件 - macOS / Linux 用户若用 SDKMAN! 管理 JDK，请确保
java命令指向的是 SDKMAN! 的 symlink（which java应返回类似~/.sdkman/candidates/java/current/bin/java）
只装这 2 个扩展：redhat.java + Extension Pack for Java
官方推荐的 Extension Pack for Java 是个合集，本质就是把几个关键扩展打包一键安装；但如果你手动选，必须包含 redhat.java（Language Support for Java™ by Red Hat），它是整个 Java 功能的基础。
-
redhat.java依赖vscode-java-debug（调试）和vscode-java-test（测试），这些通常由合集自动带入，无需单独搜 - 别装
Java Extension Pack（旧版、已弃用）、Java Language Support（非 Red Hat 维护、功能残缺） - 装完重启 VS Code —— 扩展不会在已打开的 Java 文件上自动激活，必须关掉再重开 .java 文件
项目根目录下必须有 .vscode/settings.json 或 pom.xml / build.gradle
VS Code 不像 IntelliJ 那样能“扫描整个磁盘找 Java 项目”，它只在打开的文件夹里按规则识别 Java 工程。没有项目结构标识，redhat.java 就不会加载语言服务器（JDT LS），也就没有补全、跳转、错误提示。
立即学习“Java免费学习笔记（深入）”；
- 最轻量方式：在项目根目录新建
.vscode/settings.json，写入{"java.configuration.updateBuildConfiguration": "interactive"}，保存后右下角会弹提示，点“Import”即可触发初始化 - 更常见方式：项目已有
pom.xml（Maven）或build.gradle（Gradle），VS Code 会在首次打开时自动检测并下载对应构建工具依赖 - 纯 Java 文件（无构建配置）？可以手动触发：按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Java: Configure Classpath，选 “Add Folder to Classpath” 指定 src 目录
常见错误现象与对应解法
很多“插件没反应”的问题，其实卡在前面几步。下面列几个高频症状，直接对症操作：
- 打开
.java文件，没有语法高亮、Ctrl+点击无跳转 → 检查是否打开了**包含该文件的文件夹**（不是只打开单个文件），且文件夹里有pom.xml或.vscode/settings.json - 状态栏显示 “Starting Java Language Server…” 卡住超过 1 分钟 → 查看 VS Code 右下角托盘，点
Java图标，选 “Open Log File”，检查是否因网络无法下载 JDT LS（国内用户常需配java.download.url设置为阿里云镜像） - Debug 按钮灰色、F5 启动失败 → 确保
launch.json里mainClass值写的是完整类名（如"com.example.HelloWorld"），不是文件名（HelloWorld.java） - 修改代码后热更新无效 → VS Code 默认不带热替换（Hot Reload），
redhat.java仅支持保存即编译（Save Actions），如需热部署需额外配 Spring Boot DevTools 或使用vscode-java-test运行单测
真正麻烦的从来不是插件装不装得上，而是 JDK 路径、项目结构、网络代理这三者之间哪一环断了没人告诉你。盯住状态栏右下角那个小 Java 图标，它每次变色都在说一件事：不是插件坏了，是它还没连上你的 JDK 或项目。
