根本原因是VSCode终端未继承系统PATH或Maven未正确配置环境变量，需手动将Maven的bin目录加入PATH并重启VSCode所有窗口；Java插件扫描主类路径和命名有偏好，需确保主类位置、命名规范及pom.xml配置正确；构建卡住常因误判为Gradle项目或Maven镜像配置错误；热更需显式启用DevTools依赖、JVM参数及自动编译设置。
VSCode里Maven插件装了但mvn命令报“command not found”
根本原因是VSCode终端没继承系统PATH，或者Maven没正确配置到环境变量。不是插件问题，是终端启动时找不到mvn。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 在终端里直接运行
which mvn（macOS/Linux）或where mvn（Windows），确认Maven是否真能被系统识别 - 如果命令失败，先去官网下载Maven二进制包，解压后把
apache-maven-x.x.x/bin加到系统PATH（macOS/Linux改~/.zshrc或~/.bash_profile；Windows改系统环境变量） - VSCode重启——必须关掉所有窗口再重开，否则旧的终端进程不会加载新PATH
- 别依赖“Java Extension Pack”自动配Maven路径，它只读
MAVEN_HOME，不读PATH，且不处理mvn软链接场景
Spring Boot项目右键“Run Java”失败，提示“No main class found”
VSCode的Java插件默认只扫描src/main/java下带public static void main(String[] args)的方法，但Spring Boot主类常被放在子包里，或被@SpringBootApplication修饰但命名不规范。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 检查主类是否在
src/main/java下，且包路径不含中文、空格、特殊符号 - 确认主类名以
Application或BootApp结尾（非强制但插件偏好这类命名） - 如果主类在
com.example.demo.DemoApplication，确保pom.xml里<groupid></groupid>和<artifactid></artifactid>没写错，否则编译输出目录混乱，插件找不到class文件 - 手动触发一次
mvn compile，再右键运行——很多情况下插件依赖编译后的target/classes，而非源码实时解析
点击“Debug”图标却卡在“Starting Gradle Build…”或“Resolving dependencies…”
这是VSCode用错了构建工具：你装的是Maven，但Java插件默认可能调用Gradle（尤其项目根目录有build.gradle时），或Maven本身被卡在镜像源/代理上。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 删掉项目根目录下的
build.gradle和gradlew*文件（如果不用Gradle），避免插件误判 - 检查
~/.m2/settings.xml，确认<mirrors></mirrors>里国内镜像（如阿里云）配置正确，且没拼错mirrorOf值（常见错写成*导致中央仓库被拦截） - 在VSCode设置里搜
java.configuration.updateBuildConfiguration，设为interactive，这样首次打开项目时会弹窗让你选Maven还是Gradle - 调试前先在终端跑
mvn clean compile -DskipTests，看是否真能过——如果这步都卡住，VSCode只是表象
修改代码后热更（Hot Reload）不生效，每次都要重启
VSCode本身不提供Spring Boot DevTools热更能力，它只是调用Maven插件启动，而DevTools需显式启用且依赖特定JVM参数和依赖声明。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 确认
pom.xml里已添加spring-boot-devtools依赖，并且<scope></scope>是runtime（不是provided） - 启动时必须加JVM参数：
-XX:Restart-Host=127.0.0.1 -Dspring.devtools.restart.enabled=true；VSCode调试配置里要在launch.json的vmArgs字段填上 - 别信“保存即更新”——DevTools只监听
target/classes变化，所以得确保编辑后自动编译（VSCode设置java.compile.onSave为enabled） - 静态资源（
src/main/resources/static）改完不用重启，但Java类修改后仍需触发一次保存+自动编译，不是改完立刻生效
真正卡住的点往往不在VSCode配置，而在Maven本地仓库损坏、settings.xml里镜像地址失效、或项目里混用了Maven和Gradle生命周期。遇到问题先切到终端，用mvn命令直连验证，比反复调VSCode设置更省时间。
