vscode配置java开发环境需三者协同：装对jdk 17/21并确保java/javac版本一致、安装microsoft官方extension pack for java并重启、用java: create java project向导创建标准项目或打开含pom.xml的目录并点“load project”。
VSCode 本身不带 Java 支持，必须装对 JDK、配对路径、装全插件，三者缺一不可；否则连 main 方法都识别不了，更别说调试和补全。
确认 JDK 版本和 JAVA_HOME 是否真正生效
很多人卡在这一步：终端里 java -version 和 javac -version 输出不一致，或者 echo $JAVA_HOME（macOS/Linux）或 echo %JAVA_HOME%（Windows）为空。
- 用
which java和which javac（macOS/Linux）或where java（Windows）看两个命令是否指向同一目录下的bin子目录 -
JAVA_HOME必须设为 JDK 根目录（含bin、lib、jre），不是bin本身，也不是 JRE 目录 - Windows 用户特别注意：路径含空格（如
C:Program Files...）或中文会导致 Java 扩展启动失败，建议重装 JDK 到无空格路径（如C:jdk17） - 改完环境变量后，**必须新开终端再验证**，旧终端不会自动继承新变量
只装 Extension Pack for Java，别拆开装
单独装 Language Support for Java 或 Debugger for Java 是无效的——它们依赖同一个语言服务器进程，而这个进程由 Extension Pack for Java 统一拉起和配置。
- 在 Extensions 商店搜
Extension Pack for Java，认准发布者是 Microsoft - 装完必须重启 VS Code（不是重载窗口），否则右下角看不到 JDK 版本标识
- 打开一个
.java文件，状态栏右下角应显示类似JavaSE-17；若显示No Java runtime found，说明插件根本没读到 JDK - 禁用所有其他 Java 相关扩展（比如 “Java Import Assistant”、“Better Java”），避免 LSP 端口冲突或类路径污染
手动指定 java.home 路径，别信自动探测
VS Code 的 Java 扩展自动扫描逻辑在多 JDK 环境、WSL、或路径含空格时大概率失效。靠设置界面填 java.home 最稳。
Java开发手册规约集合，基于阿里巴巴Java开发手册（嵩山版）。 涵盖7大维度：编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。 当用户需要：(1) 编写或审查Java代码 (2) 检查命名/代码规范 (3) 处理异常和日志 (4) 编写单元测试 (5) 安全编码 (6) 数据库设...
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Preferences: Open Settings (JSON) - 在
settings.json中添加（注意路径分隔符）：
{
"java.home": "/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home"
}
macOS/Linux 用正斜杠；Windows 可用正斜杠或双反斜杠，例如："java.home": "C:/jdk17" 或 "java.home": "C:\jdk17"；单反斜杠会解析失败。
- 该配置建议写在工作区
.vscode/settings.json中（项目级），而非全局用户设置，避免不同项目 JDK 版本冲突 - 填完后，再运行
Java: Configure Java Runtime，确认 Installed JREs 列表里只有一项且状态为 active
新建项目必须用向导，别直接建 .java 文件就跑
直接在空文件夹里新建 HelloWorld.java 并点运行，90% 概率报 class not found 或 source folder not recognized——因为 VS Code 不知道哪是源码根、哪是输出目录。
- 打开空文件夹 →
Ctrl+Shift+P→ 输入Java: Create Java Project→ 选Maven或Gradle（推荐 Maven）→ 填GroupId（如com.example）和ArtifactId（如hello） - 生成后，项目结构自动包含
src/main/java，此时在该目录下新建类，才能被正确识别为 source folder - 首次打开 Maven/Gradle 项目时，右下角弹出
Load project提示，**必须点“Load”**；不点则依赖不加载、补全失效、断点不命中 - 如果已有
pom.xml，直接用 VS Code 打开其所在文件夹即可，但同样要等右下角提示并点 Load
最易被忽略的是：JDK 路径填对了、插件也装了，但项目没走向导创建或没点 Load，整个语言服务就处于“半瘫痪”状态——看着有高亮，实则跳转错乱、编译不触发、测试跑不起来。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
