vscode运行java报“找不到或无法加载主类”90%是launch.json或项目结构问题：mainclass须写全限定名（如com.example.main），outputpath必须指向真实.class输出目录（如target/classes），工作区根须为含pom.xml或正确配置的项目根，且java_home需在vscode中手动配置jdk根路径。
VSCode 运行 Java 报“找不到或无法加载主类”，**90% 是 launch.json 或项目结构没对齐 classpath，不是代码写错了，也不是 JDK 没装好**。
launch.json 中 mainClass 必须写全限定名
Java 调试器启动时，mainClass 字段传给 JVM 的就是字符串字面量，它不解析包、不补路径、不猜意图。写 Main 或 MyApp.java 都会失败，必须是带包名的完整类名。
- ✅ 正确：
"mainClass": "com.example.Main"（假设源文件里有package com.example;） - ❌ 错误：
"mainClass": "Main"、"mainClass": "src/com/example/Main.java"、"mainClass": "com.example.Main.class" - 如果类在默认包（没写
package），mainClass就只能是"Main"，且项目不能有src/目录层级干扰——否则语言服务器可能拒绝识别
outputPath 必须指向真正的 .class 输出目录
VSCode Java 插件靠 java.project.outputPath（或 launch.json 里的 projectName 关联的输出路径）构建 classpath。它不会自动扫描 bin/ 或 out/，也不会 fallback 到当前目录。
- 手动编译用
javac -d out src/com/example/Main.java→ outputPath 应设为"out"（注意：是相对于工作区根的相对路径） - Maven 项目通常输出到
target/classes→ settings.json 中配"java.project.outputPath": "target/classes"，且确保已执行过mvn compile - 如果 outputPath 指向空目录或不存在路径，VSCode 不报错，但 classpath 为空，JVM 找不到任何类
- 别信
sourceFolder：它只影响代码跳转和语法提示，和运行时 classpath 无关
工作区根目录必须是项目根，且含有效元数据
VSCode Java 扩展需要靠项目根下的线索判断如何组织 classpath。没有这些，它会降级为“裸 Java 文件”模式，几乎必然失败。
- 标准 Maven 项目：工作区根下必须有
pom.xml；Gradle 项目需有build.gradle或settings.gradle - 无构建工具的项目：至少要有
.vscode/settings.json明确指定"java.project.sourcePaths"和"java.project.outputPath" - 常见陷阱：把工作区打开在
src/目录下 —— 此时 VSCode 看不到pom.xml，也找不到target/classes，直接放弃智能 classpath 构建 - 验证方式：按 Ctrl+Shift+P 输入
Java: Clean the Java language server workspace，再重启窗口，看问题是否复现
JAVA_HOME 配置错一个字符，整个 classpath 就失效
VSCode 不读系统环境变量 JAVA_HOME 或 PATH。它用自己配置的 JDK 路径启动语言服务器，而语言服务器又决定了 classpath 解析逻辑和编译目标版本。
- 必须通过 Ctrl+Shift+P →
Java: Configure Java Runtime添加 JDK 根目录（如C:\Program Files\Eclipse Adoptium\jdk-17.0.9+9），不是.../bin - Windows 下路径末尾不能有反斜杠：
C:\jdk-17\❌，C:\jdk-17✅ - 如果 JDK 版本与项目要求不一致（比如项目用 Java 17 的 sealed class，却配了 JDK 11），编译可能成功但运行时报
NoClassDefFoundError，看起来像“找不到主类” - 终端里
java -version正常 ≠ VSCode 用的是同一个 JDK —— 它俩完全独立
最易被忽略的一点：VSCode Java 插件在多模块 Maven 项目中，会根据 projectName 字段匹配模块的 artifactId，而不是目录名。填错一个字母，classpath 就漏掉整个模块的 class 和依赖 jar。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
