VSCode报“找不到主类”主因是java.project.outputPath配置错误或未配，以及launch.json中mainClass未写全限定名；必须确保outputPath指向含正确包结构的非空.class输出目录，且mainClass严格匹配package声明与文件路径，大小写、点号均不可错。
VSCode 报“找不到类”基本不是代码问题，而是 java.project.outputPath 指向了空目录、错目录，或根本没配。
launch.json 的 mainClass 必须写全限定名，且大小写/点号一个都不能错
VSCode Java 插件把 mainClass 字符串原样传给 JVM，不做任何补全或转换。哪怕你文件路径和 package 都对，这里漏个点或写错字母，就直接报 Could not find or load main class。
- ✅ 正确：
"mainClass": "com.example.App"（对应package com.example;+src/main/java/com/example/App.java） - ❌ 错误：
"mainClass": "App"（缺包名）、"mainClass": "com/example/App"（用了斜杠）、"mainClass": "com.example.App.class"（JVM 不要后缀） - ⚠️ 默认包例外：没写
package时，mainClass只能是"App"，且App.java必须直接放在src/下，不能有子目录
java.project.outputPath 必须指向含正确包结构的 .class 输出目录
VSCode 运行时只认这个配置指定的路径，并把它当 classpath 根。它不扫描硬盘、不猜路径、不读 sourceFolder —— 那个只影响跳转和提示。
- 常见错误：
"java.project.outputPath": "bin"，但实际.class在bin/com/example/App.class→ ✅ 合理；而设成"bin/com/example"→ ❌ 失败，因为 JVM 会从com/目录开始找 - Maven 项目必须先执行
mvn compile，否则target/classes是空的，配了也白配 - 手动编译时用
javac -d out src/com/example/App.java，那outputPath就得填"out"（工作区根下的相对路径）
工作区根目录必须是项目根，且含有效结构线索
VSCode Java 插件靠工作区根目录下的元数据决定怎么组织 classpath。没这些线索，它就退化成“裸文件模式”，几乎必然失败。
立即学习“Java免费学习笔记（深入）”；
- 有
pom.xml或build.gradle→ 自动识别为构建工具项目，只加载src/main/java和src/test/java - 无构建文件但存在
src/目录 → 认定为传统 Java 项目，只加载src/下内容 -
Main.java直接丢在工作区根目录 → 插件不索引，“Run Java”按钮灰色不可用 - 验证方式：终端里
pwd看当前路径是否含pom.xml或src/；不是就关掉 VSCode，重新用该目录打开工作区
别信 sourceFolder，它对运行时 classpath 完全无效
很多人改了 sourceFolder 发现还是找不到类，是因为这个配置只控制源码解析范围（比如 Ctrl+Click 跳转去哪），和 JVM 加载 .class 文件完全无关。
-
java.project.outputPath才是真正的 classpath 根，必须指向.class实际生成位置（如bin、out/production/myproject、target/classes） - 如果用 Maven，优先删掉手写的
launch.json，右键App.java→ “Run Java”，让插件自动生成配置 - 临时验证可手动进
outputPath目录，执行java -cp . com.example.App，看是否能跑通——这能快速排除路径配置问题
最容易被忽略的是：outputPath 指向的目录必须真实存在、非空、且结构完整。很多开发者配对了路径却忘了先编译，或者用 IDE 自动生成了 class 文件但路径层级和包声明不一致——这时 VSCode 什么都不会报错，只是安静地找不到类。
