VSCode的Maven插件是接入Java生态的桥梁，非单纯运行Maven工具；需满足pom.xml在打开文件夹根目录、安装vscode-maven插件、正确配置maven.executable.path指向mvn/mvn.cmd可执行文件、执行Maven: Reload project四者同时成立，否则import标红、侧边栏空白、无clean/test选项均为正常现象。
VSCode 的 Maven 插件（vscode-maven）不是“让 Maven 能运行”的工具，而是**把 Maven 项目真正接入 VSCode Java 生态的桥梁**——没它，pom.xml 就是纯文本，import 标红、跳转失效、依赖树空白、右键没 clean 或 test，全都是正常现象。
为什么 pom.xml 在根目录，Maven 侧边栏还是不出现
插件只在你用 File > Open Folder 打开的文件夹下存在 pom.xml 时才触发识别，不扫描子目录，也不认 modules/demo/pom.xml 这类路径。常见错误包括：
-
pom.xml实际在project-root/src/main/resources/pom.xml—— 这根本不是 Maven 项目结构 - 装了名字带 “Java” 但没
vscode-maven功能的插件（比如maven-pom-editor），状态栏右下角始终没有 Maven 图标 - 没执行
Maven: Reload project（Ctrl+Shift+P），插件不会主动重扫描，即使你改了pom.xml - 多模块项目只打开了子模块文件夹，
<parent>标红且无解析，必须用多根工作区把父工程也拖进来
右键 pom.xml 没有 Import to Workspace 或点完没反应
这是最典型的“插件没连上 Maven 环境”信号。VSCode 不查 PATH，也不读 MAVEN_HOME，它只认一个配置项：maven.executable.path。
Java Maven Common
下载
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
- 先在终端跑
which mvn（macOS/Linux）或where mvn（Windows），拿到真实路径，例如/opt/homebrew/bin/mvn或C:pache-maven-3.9.6inmvn.cmd - 打开设置（Ctrl+,），搜
maven.executable.path，填入**完整可执行文件路径**，不是 bin 目录，也不是MAVEN_HOME - Windows 用户注意：JSON 中单反斜杠
是转义符，必须写成C:\apache-maven-3.9.6\bin\mvn.cmd或用正斜杠C:/apache-maven-3.9.6/bin/mvn.cmd - 填完必须重启 VSCode，否则旧进程仍用空配置，
Import to Workspace会卡在 “Building workspace…” 不动
Maven: Show Dependencies 点开是空的或报错
这个命令依赖三个硬条件同时满足，缺一不可：
立即学习“Java免费学习笔记（深入）”；
-
pom.xml根节点必须含标准命名空间：<project xmlns="http://maven.apache.org/POM/4.0.0">，缺这个，VSCode 静默跳过解析 -
<packaging>不能是pom（父 POM 模块），只有jar、war、bundle等可构建类型才会生成 classpath 和依赖树 - 多模块项目必须在**父 POM 所在目录**打开工作区；如果只打开子模块文件夹，依赖树无法向上追溯 parent 或 sibling 模块
- 命令面板里搜不到
Maven: Show Dependencies？说明vscode-java-dependency扩展没激活，要确认已安装Extension Pack for Java，不是单独装了个第三方 viewer 插件
真正容易被忽略的是：VSCode 的 Maven 支持不是“一次配好就永远有效”。JDK 切换、settings.xml 修改、多根工作区增删、甚至从 Dock 启动 VSCode（macOS）都可能让环境变量失效——遇到问题，先看状态栏右下角有没有 Maven 图标和 JDK 版本号，再动手排查。
