根本原因是VSCode未将当前文件夹识别为Maven项目，因其只扫描根目录下的pom.xml且路径不能含中文、空格或特殊符号；需用VSCode打开含pom.xml的最外层文件夹，并手动执行Java: Import Java Projects触发导入。
VSCode 识别不了 Maven 项目，右键没 “Run Java”
根本原因是 VSCode 没把当前文件夹当 Maven 项目处理——它只认 pom.xml 在根目录，且路径不能含中文、空格或符号。插件不会递归扫描子文件夹找 pom.xml。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 用 VSCode 打开的必须是含
pom.xml的**最外层文件夹**，不是 src/ 或子模块目录 - 如果已打开但没反应，按
Ctrl+Shift+P输入Java: Import Java Projects，手动选中pom.xml - 检查文件系统权限：macOS/Linux 下若
pom.xml所在目录被chmod 000过，Java 插件会静默跳过 - 别依赖“自动导入”，尤其从 Git 克隆后，首次打开务必手动触发一次导入
mvn 命令报 command not found，但终端里能运行
VSCode 内置终端启动时未加载 shell 配置（如 ~/.zshrc），导致 PATH 缺失 mvn 路径。这不是插件问题，也不是 JDK 配置错。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 在系统终端运行
which mvn，确认路径（例如/opt/homebrew/bin/mvn） - Mac 用户：检查
~/.zshrc是否有export PATH="...:$PATH"且包含该路径；Windows 用户检查系统环境变量是否写入%MAVEN_HOME%\bin - VSCode 必须**完全关闭所有窗口再重开**，否则旧终端进程不刷新
PATH - 别改
maven.executable.path设置项来绕过——这会让插件跳过自动依赖解析，后续 Run/Debug 失效
点击 ▶️ Run 报 “No main class found”，但 main 方法明明存在
Java 插件默认只扫描 src/main/java 下的顶层类，且对主类命名和编译状态敏感。Spring Boot 项目尤其容易踩坑。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 主类必须在
src/main/java下，包名不能以数字开头、不能含中文，例如com.example.DemoApplication✅，com.示例.App❌ - 类名建议以
Application或BootApp结尾，插件内部有命名偏好逻辑 - 确保已执行过
mvn compile：插件依赖target/classes/下的字节码，不是实时解析源码 - 如果主类在子模块（如
app-module/src/main/java/...），需打开的是**整个多模块父目录**，且父pom.xml中声明了该模块
Run 正常但 Debug 卡在 “Starting Gradle Build…”
这是构建工具误判：项目根目录存在 build.gradle 或 settings.gradle 文件，即使你只用 Maven，Java 插件也会优先尝试调用 Gradle。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 删掉或重命名根目录下所有 Gradle 相关文件（
build.gradle,settings.gradle,gradle/目录） - 检查
.vscode/settings.json是否有残留的"java.configuration.updateBuildConfiguration": "always"，删掉它 - 重启 VSCode 后，按
Ctrl+Shift+P输入Java: Clean Java Language Server Workspace强制重载 - 热更失效？确认
pom.xml里加了spring-boot-devtools依赖，且 VSCode 设置中启用了java.debug.settings.launch.hotCodeReplace
