java.home 必须指向 JDK 根目录而非 bin 子目录，且需确保 java -version 与 javac -version 版本一致、路径相同；安装 Extension Pack for Java 后须手动配置 java.home 并重启 VS Code；项目必须含 pom.xml 或 build.gradle 才能启用完整 Java 功能；调试前需正确生成 launch.json 并准确填写 mainClass。
java.home 必须指向 JDK 根目录，不是 bin 子目录；只装插件不配路径、不验证 javac -version 一致性，90% 的“运行失败”“无补全”“断点无效”都源于此。
确认 JDK 安装正确且版本一致
VS Code 的 Java 扩展依赖系统级 JDK，不是 JRE，更不能靠系统自带或 Android Studio 附带的 JDK 混用。常见错误是java -version 和 javac -version 输出不同版本，或其中一条报 “command not found”。
- 在终端执行
which java和which javac（macOS/Linux）或where java和where javac（Windows），确认两者指向同一安装路径下的bin目录 - 若输出路径不一致，说明 PATH 中混入了多个 JDK；建议卸载冗余 JDK，或手动清理 PATH，只保留一个完整 JDK 的
bin路径 - Windows 用户注意：用桌面图标启动 VS Code 时，它读的是系统环境变量；用终端执行
code启动时，读的是当前 shell 的环境变量——二者可能不一致
装 Extension Pack for Java 并显式配置 java.home
只装插件不设路径，等于没装。Extension Pack for Java（ID：vscjava.vscode-java-pack）会自动拉取 Language Support for Java、Debugger for Java 等子扩展，但不会自动猜对 JDK 位置。
- 卸载所有第三方 Java 插件（如 “Java Import Assistant”、“Better Java”），避免 LSP 端口冲突
- 安装完后，打开 VS Code 设置（
Ctrl + ,），搜索java.home，点击 “Edit in settings.json” - 填入绝对路径，例如：
"java.home": "/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home"
"java.home": "C:\Program Files\Java\jdk-17.0.1"
- 路径末尾不能含
/bin，必须是包含bin、lib、jre的那一层根目录 - 保存后重启 VS Code，观察右下角是否出现 “Java Language Server is running”
项目必须含构建元数据，否则扩展会静默忽略
VS Code 不识别“随便放几个.java 文件的文件夹”为 Java 项目。它靠 pom.xml 或 build.gradle 自动推导源码路径、依赖和 classpath。
- 新建项目请用命令面板：
Ctrl + Shift + P→ 输入Java: Create Java Project→ 选 Maven/Gradle（推荐 Maven） - 若已有项目，确保根目录存在
pom.xml，且内容合法（至少含<groupid></groupid>、<artifactid></artifactid>、<version></version>） - 首次打开含
pom.xml的文件夹时，右下角会弹出 “Load project”，必须点击确认；否则类无法解析、无跳转、无补全 - 纯 Java 文件夹（无构建文件）想临时跑代码？可用 Code Runner 插件，但它不提供调试、跳转、Maven 集成等 IDE 级能力
调试前务必检查 launch.json 是否生成正确
F5 调试失败，大概率是没生成或没选对主类。VS Code 不会自动为你写好调试配置，尤其在多模块或非标准包结构下。
- 在项目根目录下确保有
.vscode/launch.json；若没有，按F5→ “create a launch.json file” → 选 “Java” - 检查
configurations[0].mainClass字段是否准确，例如："mainClass": "com.example.App" - 如果项目用了模块化（
module-info.java），需额外设置"vmArgs": "--module-path ${workspaceFolder}/out/production --add-modules ALL-SYSTEM"，否则NoClassDefFoundError - 修改
launch.json后无需重启，但要确保当前打开的.java文件属于该mainClass所在模块，否则断点灰色不可用
最常被忽略的一点：JDK 路径填对了，pom.xml 也加载了，但 launch.json 里写的 mainClass 是旧包名，而你刚把类移到了新 package 下——此时 F5 会静默失败，终端无输出，连错误日志都不打。
