vs code的java extension pack通常能自动识别已安装jdk并完成初始化，无需手动配置路径或重启编辑器；它通过扫描系统默认路径支持主流发行版，并在状态栏显示版本标识以确认生效。
不用手动翻 JDK 安装目录，也不用反复重启 VS Code——只要 JDK 已正确安装且在系统 PATH 中，Extension Pack for Java 通常能自动识别并完成初始化，5 分钟内可直接写、编译、调试。
Java Extension Pack 装完就跑，别急着改 settings.json
大多数新装 JDK（JDK 11+）的用户，装完 Extension Pack for Java 后打开任意 .java 文件，状态栏右下角会立刻显示类似 Java 17 的版本标识。这说明语言服务器已自动探测到 JDK，无需任何配置。
- 自动探测路径包括：
/usr/lib/jvm/（Linux）、C:Program FilesJava（Windows）、/Library/Java/JavaVirtualMachines/（macOS） - Adoptium Temurin、Oracle JDK、Amazon Corretto 等主流发行版均被支持
- 若状态栏没显示版本，先运行
java -version和echo $JAVA_HOME（macOS/Linux）或echo %JAVA_HOME%（Windows）确认系统级配置有效
需要手动指定 JDK 时，优先用命令面板而非硬写 settings.json
手动配置不是错，但容易因路径斜杠、转义、权限或拼写出错。VS Code 提供了更鲁棒的方式：
Java Development Manual
下载
Java开发手册规约集合，基于阿里巴巴Java开发手册（嵩山版）。 涵盖7大维度：编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。 当用户需要：(1) 编写或审查Java代码 (2) 检查命名/代码规范 (3) 处理异常和日志 (4) 编写单元测试 (5) 安全编码 (6) 数据库设...
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Java: Configure Java Runtime并回车 - 在弹出菜单中选
Add JDK...，然后导航选择 JDK 根目录（如/home/user/jdk-21或C:jdk-17.0.2） - 该操作会自动写入
java.home，且路径格式由 VS Code 内部标准化，避免手写"java.home": "C:\Program Files\Java\jdk-17"这类易错字符串
java.jdt.ls.java.home 和 java.home 到底该用哪个？
两个都存在，但作用不同，混用会导致冲突：
-
java.home：控制 VS Code 启动语言服务器所用的 JDK，也是插件推荐使用的配置项（官方文档已标记为“recommended”） -
java.jdt.ls.java.home：仅影响 JDT Language Server 自身运行的 JVM，一般不需要动；设错可能导致服务器启动失败，报错如Failed to launch the Java Language Server - 多 JDK 场景下，应使用
java.configuration.runtimes数组配置项目级 JDK 映射，而不是覆盖全局java.home
调试失败第一反应：检查终端是否继承了 JAVA_HOME
VS Code 的集成终端（Ctrl+`）默认不加载 shell 的完整环境变量，尤其在 macOS/Linux 上用 zsh/fish 时常见。即使 java -version 在系统终端正常，VS Code 终端里可能报 command not found。
- 验证方式：在 VS Code 终端中执行
printenv JAVA_HOME，为空则说明未继承 - 修复方法：在 VS Code 设置中启用
terminal.integrated.inheritEnv（设为true），或在settings.json中加一行："terminal.integrated.inheritEnv": true - 注意：Windows 用户通常无此问题，因 GUI 进程默认继承系统环境变量
真正卡住的点往往不在“怎么配”，而在“谁在读这个配置”——语言服务器、调试器、Maven 插件、终端各自认的路径可能不同。每次改完配置，只看状态栏右下角的 Java 版本提示，比反复查 settings.json 更快定位是否生效。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
