VSCode不会自动识别pom.xml为项目入口，必须显式导入：用File→Open Folder打开pom.xml所在顶层目录，右键pom.xml选择Import to Workspace或Reload project；若菜单无此选项，说明Extension Pack for Java未启用或pom.xml缺少xmlns声明。
VSCode 不会自动把 pom.xml 当成项目入口，依赖标红、import 报错、右键没 Maven 选项——这些问题基本都卡在“没真正导入”这一步，而不是插件装得不对或网络慢。
右键 pom.xml 没 “Reload project” 或 “Import to Workspace”
这是最常被忽略的启动动作。VSCode 不靠文件存在就自动加载项目，必须显式触发解析流程。
- 确保你用 File > Open Folder 打开的是
pom.xml所在的**顶层目录**（不是子模块、不是src下某层） - 右键点击根目录下的
pom.xml文件，菜单里必须出现 Reload project 或 Import to Workspace；没有？说明插件根本没识别到这个文件是 Maven 入口 - 如果菜单只有 “Open with” 或 “Copy Path”，大概率是没装
Extension Pack for Java，或装了但被禁用了——检查已启用扩展列表里有没有redhat.java和vscjava.vscode-java-dependency - Windows/macOS/Linux 下，
pom.xml文件头必须含标准命名空间：<project xmlns="http://maven.apache.org/POM/4.0.0">；缺这个，VSCode 会静默跳过
依赖加了但 import 还是标红，mvn compile 却能过
命令行能编译成功，说明依赖确实下载到了 ~/.m2/repository，但 VSCode 的 Java 语言服务器压根没把它们加进 classpath。
- 先运行命令面板（
Ctrl+Shift+P）→ 输入Java: Reload Projects，强制刷新 classpath 索引 - 如果状态栏右下角仍显示
Java (No Maven)或没反应，运行Java: Clean the Java language server workspace，再重启窗口 - 检查项目根目录下有没有残留的
.project或.classpath（Eclipse 遗留），有就删掉——VSCode 不读这些 -
<packaging>必须是jar、war等可构建类型；如果是pom（父模块），它不会被纳入 classpath 分析，也不会出现在依赖树里
多模块项目依赖不生效，Parent pom not found
子模块里 <parent> 标红、找不到父 POM，不是路径写错了，而是工作区结构不对。
- 必须用 VSCode 的**多根工作区**：把父工程目录和所有子模块目录一起拖进同一个窗口，或者用
File > Add Folder to Workspace逐个添加 - 只打开子模块文件夹，VSCode 就看不到父
pom.xml，自然无法解析<parent>块 - 父模块的
<packaging>必须是pom，且子模块中<version>不能是${project.version}这类变量——Maven install 时需要确定版本号 - 父模块没执行过
mvn install，它的.pom文件就不会进本地仓库；子模块 reload 后依然找不到，因为插件依赖的是本地仓库里的元数据
Maven: Show Dependencies 点不开或依赖树空白
这个命令不是“点一下就出图”，它对项目状态有硬性要求，缺一不可。
- 命令面板里搜不到
Maven: Show Dependencies？说明vscode-java-dependency扩展没激活，或当前项目没被识别为有效 Java + Maven 模块 - 即使命令存在，点开后空白，常见原因是：
pom.xml中<packaging>是pom，或项目根目录下没src/main/java这类标准源目录结构 - 依赖树展示的是 **effective dependencies**（已应用
<exclusions>和 scope 过滤后的结果），不是原始dependencies列表；想确认某个传递依赖是否被排除，右键对应节点看Exclude Dependency是否可用（灰掉 = 已被排除） - 如果树里只显示本模块，没看到父模块或 sibling 模块，说明你没在父 POM 目录打开工作区——多模块依赖分析必须从顶层开始
真正容易卡住的地方不在配置路径，而在“VSCode 是否把当前文件夹当成了 Maven 项目”。它不猜、不递归、不缓存旧状态，reload 是唯一可靠的手动同步动作。别等保存自动触发，也别信状态栏图标一直亮着就代表一切正常。
