vscode运行java需同时满足三个硬性前提：系统已安装jdk 11+且java -version与javac -version版本一致；java.home必须指向jdk根目录（非jre或bin子目录）；项目必须以含src等标准结构的根目录打开，否则插件无法识别为java工程。
VSCode 本身不运行 Java，它靠插件和你本地的 JDK 共同完成编译、类加载、调试——只要 JAVA_HOME 没配对、java.home 没填准、或项目结构没被识别，就必然卡在“找不到主类”“Unsupported class file major version”“No Java runtime”这类错误上。
Java: Configure Java Runtime 不生效？检查三个硬性前提
这个命令只是“告诉 VSCode 去哪找 JDK”，但前提是系统里真有可用的 JDK，且路径指向的是 JDK 根目录（不是 jre/ 子目录，也不是 bin/ 目录）。
- 终端执行
java -version和javac -version，输出必须一致，且版本 ≥ 11（JDK 17 / 21 最稳） - Windows 用户确认
JAVA_HOME是系统变量（非用户变量），值为类似C:\Program Files\Java\jdk-17.0.2的完整路径，末尾不带反斜杠 - macOS/Linux 用户检查
~/.zshrc或~/.bash_profile中是否写了export JAVA_HOME=$(/usr/libexec/java_home -v17)这类动态定位语句 - VS Code 设置中搜
java.home，手动填入绝对路径（别信自动检测）；若已填却无效，重启 VS Code 再试
右键 Run Java 失败？问题大概率出在项目结构
VS Code 的 Java 插件不会把单个 .java 文件当项目。它依赖明确的源码路径约定，否则连 main 方法都解析不出来。
- 不要直接打开一个
HelloWorld.java文件——要打开包含src/的文件夹（例如myproject/，里面是src/main/java/HelloWorld.java） - 最简结构：在项目根目录建
src/，把.java放进src/；然后在settings.json中加一行："java.project.sourcePaths": ["src"] - 用 Maven 初始化更可靠：
mvn archetype:generate -DgroupId=com.example -DartifactId=demo -DarchetypeArtifactId=maven-archetype-quickstart，再用 VS Code 打开demo/ - 确保
public static void main(String[] args)在顶层class中，且文件名与类名严格一致（HelloWorld.java↔class HelloWorld）
Run 和 Debug 按钮不出现？Extension Pack 没装全或冲突了
CodeLens 上的 Run / Debug 链接由 Language Support for Java™ by Red Hat 提供，但它和 Debugger for Java 必须版本兼容。混装独立插件极易导致功能缺失。
- 只装
Extension Pack for Java（微软官方打包，发布者是Microsoft），别单独装Java Test Runner或旧版Language Support for Java - 装完后重启 VS Code，打开一个
.java文件，看状态栏右下角是否显示 JDK 版本号；若显示 “No Java runtime…”，说明java.home未生效或路径错误 - 如果之前装过其他 Java 插件，先全部禁用，再重装
Extension Pack for Java - 首次打开项目时，右下角弹出 “Load project” 提示，务必点确认——否则插件不会索引源码，补全、跳转、运行全失效
输出乱码或中文显示为 ? ? ?
这不是编码设置错那么简单，VS Code 的 Java 插件会覆盖部分编码行为，尤其 Windows 下默认 GBK 与 UTF-8 混用时必现。
- 全局设
files.encoding为utf8（设置里搜就行） - 在
settings.json中强制 Java 插件使用 UTF-8："java.configuration.updateBuildConfiguration": "interactive" - 关键一步：确保 JDK 启动参数含
-Dfile.encoding=UTF-8；可在launch.json的vmArgs里加，或在settings.json中加："java.debug.settings.vmArgs": "-Dfile.encoding=UTF-8" - 如果用终端手动
java命令运行，也要加-Dfile.encoding=UTF-8，否则System.out.println("你好")就是乱码
真正卡住人的从来不是“怎么点运行”，而是 JDK 路径写错一级、项目没按 src 层级打开、或者插件版本之间互相打架。这些地方一错，VS Code 就静默失败，连报错都不给你——它根本没启动 Java 语言服务器。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
