java.home必须指向jdk根目录（含bin、lib等子目录），不能是jre或bin路径；vscode不读取系统java_home，只认该配置；设错将导致补全失效、run按钮灰显；需重启vscode并确认状态栏显示java版本。
java.home 必须指向 JDK 根目录，不是 JRE，也不是 bin
VSCode 的 Java 扩展根本不会读取系统 JAVA_HOME 环境变量，只认 java.home 设置。设错路径是“代码不补全”“跳转失效”“Run 按钮灰显”的头号原因。
-
java.home值必须是 JDK 安装的最外层目录，比如/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home（macOS）、C:\Program Files\Java\jdk-17.0.2（Windows），里面得有bin、lib、jre子目录 - 绝对不能设成
/path/to/jdk/jre（这是 JRE，缺javac）或/path/to/jdk/bin/java（这是可执行文件，不是根目录） - 设完后重启 VSCode，打开任意
.java文件，底部状态栏应显示类似Java 17的标识；若显示No Java runtime present，说明路径无效
项目必须打开文件夹，不能只打开单个 .java 文件
VSCode 的 Java 扩展默认按 Maven/Gradle 约定识别源码结构。直接双击 HelloWorld.java 打开，它压根不认为这是个 Java 项目，所有运行、调试、依赖功能都会失效。
- 正确做法：用 VSCode 的 File → Open Folder… 打开包含
pom.xml或build.gradle的整个项目目录；没有构建文件时，至少确保目录下有src/main/java结构 - 如果坚持用裸文件，必须手动在工作区
.vscode/settings.json中加配置："java.project.sourcePaths": ["src"]，且src目录下要放好包结构（如com/example/HelloWorld.java） - 右键单个
.java文件点 “Run Java”，大概率报Error: Could not find or load main class——因为 classpath 和包名对不上，不是代码问题，是路径没被识别
Extension Pack for Java 必须完整安装，不能只装 Language Support
单独装 Language Support for Java™ by Red Hat 只能高亮语法，连编译都做不到。运行和调试依赖的是整套扩展链，缺一不可。
- 唯一推荐方式：在扩展市场搜
Extension Pack for Java（发布者Red Hat或Microsoft），一键安装，它自动包含redhat.java（语言服务器）、vscjava.vscode-java-debug（调试器）、vscjava.vscode-java-test（测试支持）等核心组件 - 安装后务必重启 VSCode，首次打开 Java 文件会触发
java-language-server下载（几百 MB），需保持联网；下载卡住会导致后续全部功能异常 - 装完再检查已启用扩展列表，禁用所有其他 Java 插件（比如单独的
Debugger for Java或Maven for Java），避免端口冲突或版本不匹配引发Unable to launch the Java debugger
最容易被忽略的其实是 java.home 路径层级——很多人复制了系统里 which java 的输出，结果粘贴进去的是 /usr/bin/java 这种软链接终点，而不是 JDK 根目录。VSCode 不会帮你向上追溯，它只认你填的那个字符串是否真包含 bin/javac。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
