VSCode报“找不到主类”八成因源文件路径未放对：Java插件仅识别src/main/java（Maven/Gradle）或src（纯Java）下的类，且mainClass必须写全限定名、outputPath须指向含正确包结构的编译输出目录。
VSCode运行Java报“找不到主类”，八成不是代码写错了，而是源文件路径没放对位置——Java插件默认只认 src/main/java（Maven/Gradle）或 src（纯Java项目）下的类，其他路径一律忽略。
为什么VSCode不识别src外的Java文件
VSCode Java扩展（redhat.java）启动时会扫描工作区根目录下的标准源码路径。它不递归遍历所有.java文件，而是依赖预设规则：
- 有
pom.xml或build.gradle→ 自动认定为构建工具项目，只加载src/main/java和src/test/java - 无构建文件但存在
src/目录 → 认定为传统Java项目，只加载src/下内容 - 文件直接放在工作区根目录（如
Main.java）→ 插件压根不索引，右键“Run Java”按钮灰色不可用
src/main/java和src目录结构必须严格匹配包名
Java运行靠的是「类路径根 + 包名路径」，不是源码路径。比如你写了package com.example;，那Main.java就必须在：
- Maven项目：
src/main/java/com/example/Main.java，编译后生成target/classes/com/example/Main.class - 纯Java项目：
src/com/example/Main.java，编译后应输出到bin/com/example/Main.class（不能是src/com/example/Main.class）
常见错误：把com/example/Main.java直接丢进src/，却不建com/example/子目录——这样javac能编译，但java com.example.Main一定失败，因为class文件不在com/example/结构里。
launch.json里mainClass写错包名是最隐蔽的坑
即使目录结构全对，launch.json中mainClass字段漏了包名、多加了.java或.class，都会触发“找不到主类”：
- ✅ 正确：
"mainClass": "com.example.Main" - ❌ 错误：
"mainClass": "Main"（缺包名） - ❌ 错误：
"mainClass": "src/main/java/com/example/Main.java"（这是源码路径，不是类名） - ❌ 错误：
"mainClass": "com.example.Main.class"（JVM不要后缀）
注意：mainClass值必须和package声明 + 文件路径完全一致，大小写一个字母都不能错。
手动编译后仍找不到，先看outputPath指向哪
VSCode Java插件运行时用的classpath，由java.project.outputPath决定，不是你手动javac -d的路径。如果这个配置指向空目录或错误目录（比如target/classes但还没执行mvn compile），它就真找不到class文件。
- 检查
.vscode/settings.json里是否有"java.project.outputPath": "bin"或"target/classes" - 确认该路径下是否存在对应包结构，例如
bin/com/example/Main.class - 如果用了Maven，别手写
launch.json——删掉它，右键src/main/java/com/example/Main.java→ “Run Java”，让插件自动生成
最易被忽略的一点：改完settings.json或launch.json后，必须重启Java语言服务器（命令面板 → Java: Clean Java Language Server Workspace + Java: Refresh Language Server），否则旧缓存还在生效。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
