VSCode需配合Java扩展和外部工具才能运行Maven项目；必须安装Java Extension Pack、配置JDK与Maven命令行、启用Project Manager for Java，并手动重载pom.xml以同步依赖，否则易出现类找不到或符号无法解析问题。
VSCode 本身不内置 Java 构建和依赖管理能力，必须靠扩展 + 外部工具协同工作；直接装个插件点几下就想跑 Maven 项目，大概率卡在 ClassNotFoundException 或 Cannot resolve symbol。
装对扩展：Java Extension Pack 是起点，不是全部
只装 Extension Pack for Java（含 Language Support、Debugger、Test Runner 等）能提供基础编辑支持，但无法自动下载依赖或构建项目。它依赖本地已安装的 jdk 和 maven（或 gradle）命令行工具。
- 确认
java -version和mvn -v在终端中可执行，否则扩展会反复提示“JDK not found” - 不要禁用
Project Manager for Java—— 它负责解析pom.xml并注册依赖到 classpath - 如果用 Gradle，额外启用
Gradle for Java，并确保gradle wrapper存在（即项目根目录有gradlew）
pom.xml 改了，为什么 VSCode 不重新下载依赖？
VSCode 的 Java 扩展默认不会监听 pom.xml 变更并自动刷新，需要手动触发依赖同步。这不是 bug，是设计上的“按需加载”策略，避免频繁重索引拖慢编辑器。
- 右键点击
pom.xml→ 选择Reload project - 或按
Ctrl+Shift+P（Windows/Linux） /Cmd+Shift+P（macOS），输入Java: Reload Projects - 若看到
Downloading maven-metadata.xml卡住，检查~/.m2/settings.xml是否配置了不可达的私有仓库
依赖显示灰色、import 报错，但 mvn compile 能过
这是 classpath 同步失败的典型表现：Maven 命令行能跑，说明依赖确实下载到了 ~/.m2/repository，但 VSCode 没把它们加进 Java 项目的构建路径里。
立即学习“Java免费学习笔记（深入）”；
- 打开命令面板 → 运行
Java: Clean the Java language server workspace，再重启窗口 - 检查项目根目录是否有
.project或.classpath（Eclipse 遗留文件），有就删掉——VSCode 不读这些 - 确保
pom.xml中的<packaging>是jar或war，而非pom（后者不参与编译，不会被识别为可构建模块）
真正麻烦的不是配置步骤，而是当项目含多模块、自定义 settings.xml、或用了 Spring Boot 的 spring-boot-maven-plugin 时，VSCode 的 classpath 解析容易漏掉 target/classes 或 BOOT-INF/classes —— 这类问题得靠 Java: Configure Classpath 手动补路径，而不是指望自动发现。
