必须正确配置java.home路径，避免多JDK冲突、中文/空格路径及JRE误用；精简Java Extension Pack，单文件调试需右键Run Java并确保包路径匹配。
装对 JDK 版本，别只看“最新”
VSCode 本身不自带 Java 运行时，java.home 配置错是启动报错的头号原因。常见错误如 The java.home variable is not set 或 Cannot resolve JDK，往往不是没装 JDK，而是装了多个版本（比如系统自带 OpenJDK、Android Studio 带的、手动下载的 JDK 17/21），VSCode 找不到或选错了。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 用终端执行
which java（macOS/Linux）或where java（Windows），再运行java -version和java -XshowSettings:properties -version 2>&1 | grep "java.home"确认实际生效的java.home路径 - VSCode 中按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Java: Configure Java Runtime，在弹出界面里手动添加你确认可用的 JDK 路径（例如/Library/Java/JavaVirtualMachines/jdk-17.0.1.jdk/Contents/Home或C:\Program Files\Java\jdk-21） - 避免使用 JRE；必须是完整 JDK（含
javac），否则Java Extension Pack无法编译
Extension Pack 要精简启用
官方推荐的 Java Extension Pack 是个合集，包含 Language Support for Java、Debugger for Java、Test Runner for Java 等。但轻量级需求下，很多组件反而拖慢启动、触发误报。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 卸载不用的扩展：比如不需要 Maven 项目管理，就禁用
Maven for Java；不写单元测试，可暂时禁用Test Runner for Java - 关键必留三项：
Extension Pack for Java（注意不是“Pack”，是“Extension Pack”）、Language Support for Java、Debugger for Java - 检查设置中
java.configuration.updateBuildConfiguration设为interactive，避免自动改pom.xml或build.gradle
单文件运行别依赖 project structure
很多人新建 HelloWorld.java 后点右上角 ▶️ 按钮没反应，或报 No Java runtime present，其实是 VSCode 默认把单 .java 文件当“无项目”处理，跳过了 JDK 自动探测逻辑。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 右键文件 →
Run Java（不是顶部菜单的 Run → Run Without Debugging） - 确保文件顶部有合法包声明或无包声明但路径不嵌套；若写了
package demo;，文件就必须放在demo/HelloWorld.java子目录下 - 临时调试单文件，可在文件同目录建空
.vscode/settings.json，写入：{ "java.home": "/path/to/your/jdk" }（路径替换成你真实的 JDK 路径）
中文路径和空格是静默杀手
VSCode 的 Java 扩展对含中文、空格、括号的路径兼容性差。典型现象：代码无报错、调试按钮灰色、终端输出 Error: Could not find or load main class 却找不到具体哪步失败。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 把工作区挪到纯英文路径，例如
C:\code\hellojava或~/dev/java-demo - 检查
java.home路径本身也不能含空格——像C:\Program Files\...就不行，要改用C:\Progra~1\...或重装 JDK 到C:\jdk21 - VSCode 设置里关闭
java.silentCheckJDK（设为false），让它在出问题时明确提示路径错误，而不是静默跳过
java -version 和 javac -version 是否一致，比反复重装扩展有用得多。 
