Java命令报错是因为插件不提供JDK，需手动配置JDK路径到PATH和JAVA_HOME，并确保VSCode正确加载环境变量；项目需有src、pom.xml或build.gradle等标识文件，且settings.json中java.home须指向JDK根目录并重启生效。
Java Extension Pack 装了为啥 java 命令还是报错？
装完插件不等于 Java 环境就通了——插件只负责编辑、调试和智能提示，java、javac 这些命令得靠系统 PATH 里真有 JDK 才能跑起来。
常见错误现象：Command 'Java: Create Java Project' resulted in an error (command 'extension.java.action.createJavaProject' not found) 或终端里敲 java -version 提示“command not found”。
- 先确认本地是否真的装了 JDK（不是 JRE），推荐用
jdk-17或jdk-21，避免用旧版或厂商定制版（如某些预装的 OpenJDK 可能缺javac） - Mac/Linux 用户检查
$JAVA_HOME是否指向 JDK 根目录（比如/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home），且该路径已加进$PATH - Windows 用户重点看系统环境变量：必须同时设置
JAVA_HOME（值为 JDK 安装路径，如C:\Program Files\Java\jdk-17.0.1）和把%JAVA_HOME%\bin加进Path - VSCode 启动方式影响环境变量：从终端启动
code会继承 shell 环境；从桌面图标启动可能读不到你 shell 里配的$JAVA_HOME—— 重启 VSCode 前先关掉所有窗口，再用终端执行code
VSCode 识别不到项目里的 src 和 module-info.java 怎么办？
Java 插件依赖项目结构和配置文件来激活语言服务。没有正确标识，连基础补全都会失效。
使用场景：新建空文件夹后直接写 .java 文件，或从 Git 克隆一个没 .vscode/settings.json 的老项目。
立即学习“Java免费学习笔记（深入）”；
- 确保根目录下有
src文件夹（哪怕空着），或存在pom.xml（Maven）、build.gradle（Gradle）——插件会自动识别这些构建文件并加载项目 - 如果用模块化（Java 9+），必须在
src下放module-info.java，且内容不能是空的；否则插件可能降级为“无模块”模式，导致包导入异常 - 手动触发项目加载：按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入Java: Configure Classpath，选当前文件夹，再点Reload Project - 别忽略
.project或.classpath（Eclipse 遗留文件）——它们可能干扰 VSCode 的自动识别，建议删掉再重载
Java Home 配置写在哪？settings.json 还是 launch.json？
两个地方都可能涉及，但用途完全不同：一个是编译运行时用的 JDK，一个是调试器启动时用的 JVM。
参数差异："java.home" 控制插件底层行为（如编译、类路径解析），而 "vmArgs" 在 launch.json 里只影响 debug 进程的 JVM 参数，不改变编译目标版本。
- 全局或工作区
settings.json中设"java.home"：值必须是 JDK 根路径（不是bin子目录），例如"java.home": "/opt/java/jdk-17" - 不要在
launch.json里写"java.home"—— 它不认这个字段，写了也无效 - 如果项目需要不同 JDK 版本（比如编译用 JDK 17，但 debug 时想用 JDK 21 的新特性），只能通过
settings.json切换，然后手动重载窗口；VSCode 不支持 per-launch 配置 JDK - 改完
settings.json后，务必右下角点击 Java 图标 → “Select Java Runtime”，确认显示的是你刚配的版本，否则配置没生效
为什么 System.out.println 有提示，但 Optional.ofNullable 没有？
这不是插件问题，而是 JDK 版本和项目语言级别不匹配。插件根据 java.version 和 sourceCompatibility 推断可用 API。
性能 / 兼容性影响：低语言级别（如 8）会让插件主动隐藏 Java 9+ 新增类，即使 JDK 本身支持，IDE 也不提示——这是为了防止误用导致编译失败。
- 检查项目根目录是否有
.java-version文件，或pom.xml里的maven.compiler.source是否设为17或更高 - 没有构建文件时，在
settings.json加上"java.configuration.updateBuildConfiguration": "interactive"，保存任意.java文件后会弹窗问你语言级别，选对版本 - Gradle 项目还要确认
org.gradle.java.home指向的 JDK 和sourceCompatibility一致，否则插件可能读到 JDK 8 却看到build.gradle写着JavaVersion.VERSION_17，陷入混乱 - 最稳的办法：删掉
.vscode文件夹 +.project类残留，重启 VSCode，让插件从头识别一次
Java 的版本感知是隐式的，不是装了高版本 JDK 就自动解锁全部 API —— 每个项目都得明确告诉 VSCode：“我打算用哪个版本写”。这点容易被跳过，结果就是补全残缺、类型推导出错、甚至调试时变量值显示为 unavailable。
