VSCode运行Java失败主因是java.home路径错误、未装Extension Pack for Java、未打开项目文件夹；必须指向JDK根目录（非bin/jre）、安装Red Hat官方扩展包、通过“Open Folder”加载含src或pom.xml的项目结构。
VSCode 运行 Java 代码失败，90% 是因为 java.home 指向了错误路径、没装对扩展、或根本没打开项目文件夹——它不支持直接右键单个 .java 文件运行。
java.home 必须指向 JDK 根目录，不是 bin，不是 jre，不能带中文/空格
VSCode 的 Java 扩展完全不读系统 JAVA_HOME，也不自动 fallback 到 PATH；它只认你手动填进 java.home 的那个绝对路径。填错就卡在 “No Java runtime present” 或语言服务器起不来。
- 正确路径示例：
"java.home": "/Library/Java/JavaVirtualMachines/jdk-17.0.2.jdk/Contents/Home"（macOS）、"java.home": "C:\Program Files\Eclipse Adoptium\jdk-17.0.2-hotspot"（Windows） - 错误写法：
"java.home": "C:\Program Files\Java\jre1.8.0"（JRE 不行）、"java.home": "C:\jdk-17\bin"（不能到bin子目录）、"java.home": "D:\my jdk"（路径含空格/中文会静默失败） - 多 JDK 场景下，优先在项目根目录建
.vscode/settings.json写java.home，避免和别人或自己其他项目冲突
必须装 Extension Pack for Java，别单独装“Java Extension”
单独启用 Language Support for Java™ 或 Debugger for Java 会导致功能断裂：Run 按钮不出现、断点灰色、import 标红但 mvn compile 能过——这是扩展间版本不匹配的典型症状。
- 去 Extensions 商店搜
Extension Pack for Java，认准发布者是 Red Hat（不是 Microsoft 旧版，也不是第三方“Java IDE”） - 安装后必须重启 VSCode（不是重载窗口），否则 Language Server 不启动
- 首次打开
.java文件时，会自动下载约 100MB 的 Java language server，需稳定网络；若卡在 “Starting the Java Language Server”，先检查java.home是否真能访问（比如权限不足、路径不存在）
运行 Java 代码必须打开文件夹，不能只开单个 .java 文件
VSCode 的 Java 扩展对“裸文件”几乎不支持：右键 HelloWorld.java → Run Java，大概率报 No main class found 或 Cannot resolve classpath。它需要项目结构来推导源码路径、依赖和主类。
立即学习“Java免费学习笔记（深入）”；
- 正确做法：新建空文件夹 → 用 VSCode 打开该文件夹 →
Ctrl+Shift+P→ 输入Java: Create Java Project→ 选 Maven/Gradle → 填GroupId/ArtifactId，自动生成src/main/java等标准结构 - 已有 Maven 项目？直接打开含
pom.xml的根目录，右下角弹出 “Load project” 一定要点确认，否则依赖不会解析、import全标红 - 实在只想试单文件：手动建
src目录 → 把.java放进去 → 在.vscode/settings.json加"java.project.sourcePaths": ["src"]
运行和调试必须用 CodeLens，别信右键菜单
扩展会在每个含 public static void main(String[] args) 的类顶部注入 Run / Debug 链接。这是唯一被完整测试过的入口；右键菜单里的 “Run Java” 是 Code Runner 插件提供的简易逻辑，不走 Java 扩展的 classpath 和 JVM 参数，容易漏依赖、无法调试、不读 vmArgs。
- 看到类名上方出现
Run • Debug • Test（三连小字）才算环境真正就绪 - 点击
Debug后，如果断点变实心但不命中，检查launch.json里mainClass是否写对全限定名（如com.example.HelloWorld），不是文件名 - 想改 JVM 参数？在
.vscode/launch.json的配置里加"vmArgs": "-Xmx512m -Dfile.encoding=UTF-8"
最容易被忽略的是：VSCode 的 Java 支持本质是“项目感知型”，不是“文件感知型”。它不关心你写了什么代码，只关心你打开了什么结构、指定了哪个 JDK、有没有让扩展加载成功。状态栏没显示 JDK 版本号，就别急着写业务逻辑——那只是编辑器在假装工作。
