vscode需安装java extension pack并配置jdk 11–21路径，确保language server正常启动；项目需含pom.xml或build.gradle并手动导入；运行优先用右键菜单而非launch.json。
VSCode 本身不内置 Java 支持，必须靠扩展补全核心能力；只装 Extension Pack for Java 是最简可行路径，但需注意它依赖的底层组件（如 JDK、Language Server）必须提前就位，否则扩展会“静默失效”。
装对扩展包：别单独凑功能，用官方推荐组合
单独安装 Java Extension Pack 即可，它已预打包 5 个关键扩展：Language Support for Java、Debugger for Java、Test Runner for Java、Project Manager for Java、Visual Studio IntelliCode。手动逐个装容易漏掉依赖或版本冲突。
- 在 VSCode 扩展市场搜
redhat.java（这是Language Support for Java的发布者 ID），确认作者是 Red Hat，避免误装仿冒扩展 - 安装后重启 VSCode，不要跳过这步——扩展初始化需要完整加载语言服务器
- 如果已装过旧版 Java 扩展，先禁用再装
Java Extension Pack，否则可能触发java.home配置冲突
配置 JDK 路径：不是“能运行就行”，而是要匹配扩展要求
Language Support for Java 默认使用 java.home 指向的 JDK 来启动 Java Language Server，这个 JDK 必须是 JDK 11–21（推荐 JDK 17 或 21），且不能是 JRE 或仅含 JRE 的 OpenJDK 构建版。
- 在 VSCode 设置中搜索
java.home，填入 JDK 根目录（如/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home或C:Program FilesJavajdk-17.0.1），不是bin子目录 - 终端执行
java -version和javac -version输出必须一致；若不一致，说明系统 PATH 混用了不同 JDK，需清理 - Windows 用户注意反斜杠转义问题：VSCode 设置里用正斜杠或双反斜杠，例如
C:\Program Files\Java\jdk-17.0.1
项目识别失败？检查 .vscode/settings.json 和 pom.xml / build.gradle 是否匹配
VSCode 不自动识别 Maven/Gradle 项目结构，需靠扩展解析 pom.xml 或 build.gradle。常见现象是类名不报错、无跳转、无自动导入——本质是项目未被 Language Server 加载。
立即学习“Java免费学习笔记（深入）”；
- 确保项目根目录下有
pom.xml（Maven）或build.gradle（Gradle），且文件语法合法（可用mvn validate或gradle build --dry-run快速验证） - 首次打开项目时，右下角会弹出 “Import project?” 提示，点 “Yes”；若没弹出，手动按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入Java: Import Projects并执行 - 如果项目含多模块，检查
.vscode/settings.json中是否误设了"java.configuration.updateBuildConfiguration": "interactive"，应改为"always"或删掉该行
运行 Java 类失败：launch.json 不是必需项，但 classpath 容易错
VSCode 的 Run 按钮（绿色三角）调用的是扩展内置的启动逻辑，不依赖 .vscode/launch.json；但如果自定义了 launch.json，反而可能因 classpath 或 mainClass 错误导致启动失败。
- 优先用右键菜单的
Run Java或Debug Java，它们会自动推导 classpath 和主类 - 若需调试参数（如 JVM args），再创建
.vscode/launch.json，其中mainClass必须写全限定名（如"com.example.HelloWorld"），不能只写类名 - 遇到
ClassNotFoundException，大概率是模块路径（--module-path）或类路径（-cp）未包含 target/classes 或 build/classes，此时应回退到用 Maven 插件运行（mvn exec:java）验证是否为 VSCode 配置问题
真正卡住的地方往往不在扩展本身，而在 JDK 版本与 Language Server 的兼容性、项目元数据的解析时机、以及 VSCode 后台 Java 进程是否意外僵死——遇到无响应或高 CPU 占用，先查 ps aux | grep java（macOS/Linux）或任务管理器，杀掉残留的 java -jar *.jar 进程再试。
