VS Code需手动配置JDK路径才能运行Java；必须安装JDK并设java.home为JDK根目录（非JRE或bin），验证java -version/javac -version后，在settings.json中配置路径，重启即可启用Java扩展及调试功能。
VS Code 本身不内置 Java 运行时，必须手动配置 JDK 路径才能编译和运行 Java 项目；没配对 java.home，Extension Pack for Java 会报 “No Java runtime present” 或直接无法启动语言服务器。
确认已安装 JDK 并验证命令行可用
VS Code 不会帮你装 JDK，它只读取系统已有环境。先在终端执行：
java -version
javac -version
两者都应输出版本号（如 17.0.1 或 21.0.2）。若失败，说明 JDK 未安装或未加入 PATH。Windows 用户注意：安装 JDK 时勾选 “Add to PATH”；macOS 用 brew install openjdk@21 后需软链：sudo ln -s /opt/homebrew/opt/openjdk@21/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk-21.jdk。
在 VS Code 中设置 java.home 指向 JDK 根目录
不是 JRE 路径，也不是 bin 目录，而是 JDK 安装根路径（含 lib、bin、jre 子目录的那个文件夹）。
立即学习“Java免费学习笔记（深入）”；
- Windows 典型路径：
C:\Program Files\Java\jdk-21.0.2 - macOS：
/Library/Java/JavaVirtualMachines/jdk-21.0.2.jdk/Contents/Home或/opt/homebrew/opt/openjdk@21/libexec/openjdk.jdk/Contents/Home - Linux：
/usr/lib/jvm/java-21-openjdk-amd64（路径因发行版和安装方式而异）
打开 VS Code 设置（Cmd+, 或 Ctrl+,），搜索 java.home，点击 “Edit in settings.json”，填入绝对路径：
"java.home": "/Library/Java/JavaVirtualMachines/jdk-21.0.2.jdk/Contents/Home"
改完保存，重启 VS Code —— 此时状态栏左下角应显示 Java 版本号，且 Extension Pack for Java 的语言服务会自动拉起。
创建并运行一个最简 Java 项目（不用 Maven）
VS Code 对纯 .java 文件支持良好，但需确保文件结构满足基本要求：
- 文件名必须与
public class名完全一致（大小写敏感） - 若类在 package 中（如
package hello;），则.java文件必须放在对应子目录（hello/HelloWorld.java） - 右键文件 → “Run Java” 依赖插件自动调用
javac+java，但仅当java.home正确且无编译错误时才生效
常见失败现象：Exception in thread "main" java.lang.NoClassDefFoundError —— 多半是 package 声明与目录结构不匹配，或运行时工作目录不对（建议用 VS Code 内置终端进入源码所在目录再手动试 javac HelloWorld.java && java HelloWorld 排查）。
调试时 launch.json 配置的关键点
点击 “Run and Debug” 侧边栏 → “create a launch.json file” → 选 “Java”，生成的默认配置通常能用，但要注意两个易错项：
-
mainClass必须写全限定名（含 package），例如"mainClass": "hello.HelloWorld"，不能只写HelloWorld -
projectName字段可省略；但若项目含多个 module，需确保classPaths指向正确的bin或target/classes - 调试控制台默认不显示
System.out实时输出？检查console字段是否为"integratedTerminal"（推荐），而非"internalConsole"
Java 调试高度依赖 java.home 和编译产物位置，一旦断点不触发或变量显示
真正卡住的地方往往不是“怎么配”，而是 JDK 路径里混进了空格、符号链接没解引用、或者用了 JRE 替代 JDK —— 这些问题不会报明确错误，只会让整个 Java 扩展静默失效。
