VSCode Java开发需JDK、扩展、构建工具三者协同且顺序不可乱：先装JDK 17/21并配好JAVA_HOME和PATH，再装Java扩展并手动设置java.home指向JDK根目录，最后确保项目含pom.xml或build.gradle且结构规范。
VSCode 本身不自带 Java 支持，必须通过扩展 + JDK + 构建工具三者协同才能正常编译、调试、跳转——缺一不可，且顺序不能乱。
安装 JDK 并验证 java 和 javac 可用
VSCode 的 Java 扩展（如 redhat.java）依赖系统级 JDK，不是 JRE。JDK 8–21 均可，但推荐 JDK 17（LTS）或 JDK 21（最新 LTS），避免用 JDK 22+（部分扩展尚未完全适配）。
- 下载 OpenJDK（推荐 Eclipse Temurin 或 BellSoft Liberica），解压后配置
JAVA_HOME环境变量指向根目录（如/opt/java/jdk-17.0.1） - 终端执行
java -version和javac -version，输出版本号一致才算成功；若报 “command not found”，检查$JAVA_HOME/bin是否已加入PATH - Windows 用户注意：PowerShell 和 CMD 的环境变量可能不同步，VSCode 启动方式（桌面图标 vs 终端中用
code命令）会影响它读取哪套环境变量
安装 Java 扩展包并设置 java.home
仅装 Extension Pack for Java（红帽官方合集）还不够。VSCode 可能找不到你装的 JDK，尤其当系统有多个 JDK 或 JAVA_HOME 未生效时，必须显式指定路径。
- 在扩展市场搜索安装：
Language Support for Java、Debugger for Java、Test Runner for Java（合集已含） - 打开 VSCode 设置（
Ctrl+,），搜索java.home，点击 “Edit in settings.json”，填入绝对路径，例如："java.home": "/opt/java/jdk-17.0.1"
- 路径末尾不要加
/bin—— 这是常见错误，java.home必须指向 JDK 根目录，不是bin子目录 - 改完保存，重启 VSCode；观察右下角是否出现 “Java Language Server is running” 提示，否则检查路径权限或日志（
Output面板选 “Java”）
项目结构要符合 Maven/Gradle 约定，否则无法识别为 Java 项目
VSCode 的 Java 扩展不会把任意 .java 文件当项目处理。它靠构建工具元数据（pom.xml 或 build.gradle）自动发现源码路径、依赖和 classpath。
立即学习“Java免费学习笔记（深入）”；
- 新建项目建议用命令行初始化：
mvn archetype:generate -DgroupId=com.example -DartifactId=demo -DarchetypeArtifactId=maven-archetype-quickstart - 项目根目录必须含
pom.xml（Maven）或build.gradle（Gradle），且src/main/java下有包结构（如com/example/App.java） - 如果只是丢几个
.java文件进空文件夹，扩展会静默忽略——连语法高亮都可能不触发 - Gradle 用户注意：首次导入可能卡在 “Building workspace”，需等 Gradle daemon 启动完成；可临时关闭
java.configuration.updateBuildConfiguration设为interactive避免自动同步失败
调试启动失败？重点检查 launch.json 的 mainClass 和类路径
点击 “Run and Debug” → “create a launch.json file” → 选 “Java”，生成的配置默认只适用于 Maven 标准结构。一旦包名或主类名写错，就会报 ClassNotFoundException 或 NoClassDefFoundError。
-
mainClass值必须是完整限定名（full qualified name），例如"com.example.App"，不能写成App.java或src/main/java/com/example/App.java - 如果项目用了模块（
module-info.java），需在launch.json中补充"vmArgs": "--module-path ${workspaceFolder}/target/classes --add-modules ALL-SYSTEM" - 调试时控制台显示 “Source not found”？说明 classpath 没对上——检查
target/classes（Maven）或build/classes/java/main（Gradle）是否被正确加入 - 不建议手动编辑
launch.json来绕过构建工具；优先用 Maven/Gradle 插件（如exec:java）做快捷启动
最常被忽略的是：VSCode Java 支持高度依赖后台语言服务器（jdt.ls）的初始化状态，而它的启动日志藏在 Output 面板里——出问题时不看那里，90% 的配置尝试都是盲调。
