vscode必须手动配置maven.executable.path指向mvn/mvn.cmd可执行文件，而非目录或path；否则右键pom.xml“import to workspace”会卡住、依赖不加载、import标红，尽管终端mvn compile能成功。
VSCode 不会自动识别你装好的 Maven，必须手动告诉它 mvn 命令在哪；否则右键 pom.xml 点 “Import to Workspace” 会卡住、依赖不加载、import 全标红，但终端里 mvn compile 却能成功——这是最典型的“VSCode 没连上 Maven”的表现。
VSCode 找不到 mvn 命令：不是插件没装，是路径没填对
VSCode 的 Maven 插件（vscode-maven）默认不查系统 PATH，也不会读 MAVEN_HOME，它只认一个硬配置项：maven.executable.path。填错路径或指向目录而非可执行文件，就会彻底失效。
- 先在终端运行
which mvn（macOS/Linux）或where mvn（Windows），拿到真实路径，例如/opt/homebrew/bin/mvn或C:pache-maven-3.9.6inmvn.cmd - 打开 VSCode 设置（
Ctrl+,），搜索maven.executable.path，点击 “Edit in settings.json”，填入**完整文件路径**，不是bin目录，也不是MAVEN_HOME - Windows 用户注意：路径中用正斜杠
/或双反斜杠\，单反斜杠会被 JSON 解析为转义符，导致路径无效 - 填完重启 VSCode——不重启，旧进程仍用空配置
Import to Workspace 没反应或一直 Building：项目没被识别为 Maven 工作区
VSCode 只在你用 File > Open Folder 打开的**根目录下存在 pom.xml** 时，才可能激活 Maven 上下文。它不会递归扫描子目录，也不支持多级嵌套自动识别。
- 确认
pom.xml文件就在你打开的那个文件夹里，不是藏在modules/demo/pom.xml这类子路径下 - 确保已安装官方插件
vscode-maven（作者 redhat），别用名字带 “Java” 但实际不提供 Maven 功能的山寨插件 - 按
Ctrl+Shift+P输入Maven: Reload project强制触发解析；如果状态栏右下角始终没出现 Maven 图标，说明插件根本没检测到项目 - 若项目含父 POM（
<parent></parent>），而父工程不在当前工作区，子模块会变成“裸 XML”——把父工程也加进多根工作区（Add Folder to Workspace）
依赖类 import 标红，但 mvn compile 能过：Maven 项目没真正导入
VSCode 把 Java 项目分两类处理：“普通文件夹” 和 “Maven 工作区”。只有后者才会解析 pom.xml、下载依赖、索引 jar 包里的类，进而支撑 import 补全和跳转。
- 右键
pom.xml→ 选Import to Workspace（不是 “Open with” 或 “Run as Maven build”） - 观察状态栏右下角是否显示
Building workspace，完成后应出现Java Projects: X projects - 如果提示
Project configuration is not up-to-date with pom.xml，点通知里的Update project（等价于执行mvn eclipse:eclipse的旧逻辑，但 VSCode 内部用 JDT LS 实现） - 中文路径、空格、特殊符号会导致 Maven 插件静默失败，建议项目路径纯英文、无空格
java.home 和 Java: Configure Java Runtime 到底该信谁？
java.home 是旧式配置，容易被覆盖或忽略；Java: Configure Java Runtime 是当前 Java 扩展优先读取的权威来源，尤其在多 JDK 场景下更可靠。
- 按
Ctrl+Shift+P输入并运行Java: Configure Java Runtime - 在 “JDKs” 标签页点 + Add JDK，**直接浏览到 JDK 根目录**（如
C:Program FilesJavajdk-17.0.2或/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home），不要选bin或jre子目录 - 删掉
settings.json中过时的java.configuration.runtimes硬编码（比如还留着 JDK 8 的路径），避免版本错配 - 状态栏右下角应显示 JDK 版本号（如
17），若仍显示Not found，检查目录权限（macOS/Linux 用ls -ld看是否可读）
最易被忽略的一点：VSCode 终端和 Maven 插件走的是两套路径逻辑。插件靠 maven.executable.path，而你在内置终端里敲 mvn 靠的是系统 PATH。两者不一致时，插件能跑，终端报错；或者反过来——务必分开验证、分别配置。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
