根本原因是vscode的jdt.ls按单模块加载pom.xml，未显式声明完整坐标（groupid/artifactid/version）的跨模块依赖无法被识别；需确保子模块dependency完整、parent正确、执行mvn install后手动clean ls workspace并重开根目录。
为什么多模块项目里 classpath 总是乱套？
根本原因不是 VSCode 本身，而是 Maven 多模块的 classpath 构建逻辑和 VSCode Java 扩展对模块间依赖的解析不一致。VSCode 的 Language Server（JDT.LS）默认按单模块方式加载每个 pom.xml，若子模块未显式声明对父模块或兄弟模块的 <dependency></dependency>，它就看不到那些类——哪怕它们在同一个 workspace 里。常见现象包括：Cannot resolve symbol、NoClassDefFoundError 在运行时爆发、断点进不去兄弟模块的代码。
如何让 VSCode 正确识别跨模块依赖？
关键在于确保每个子模块的 pom.xml 中，对其他模块的引用是完整且可解析的坐标，而不是仅靠相对路径或 IDE 猜测：
- 检查所有子模块的
<dependency></dependency>是否包含完整的<groupid></groupid>、<artifactid></artifactid>、<version></version>—— 不能省略<version></version>，即使它和父 POM 一致； - 确认父 POM 的
<packaging>pom</packaging>正确，且所有子模块的<parent></parent>段落指向该父 POM； - 避免使用
<scope>system</scope>或本地<systempath></systempath>引用兄弟模块，这会绕过 Maven 仓库机制，VSCode 无法索引； - 执行
mvn install（非mvn compile）后再刷新 VSCode 项目，确保子模块 JAR 已写入~/.m2/repository，JDT.LS 才能从本地仓库加载其 classpath。
mvn dependency:tree 显示正常，但 VSCode 还是报错？
这是典型“Maven CLI 可见，但 JDT.LS 不可见”的脱节。VSCode 的 Java 扩展不会自动监听 mvn install 后的本地仓库变更，必须手动触发重载：
- 打开命令面板（
Ctrl+Shift+P），运行Java: Clean Java Language Server Workspace； - 关闭并重新打开根目录文件夹（不是单个子模块文件夹）；
- 等待右下角出现 “Building Java project…” 完成，再检查
JAVA PROJECTS侧边栏中各模块的Dependencies节点是否展开并包含预期的兄弟模块条目； - 如果仍有缺失，检查
settings.json中是否误设了"java.configuration.updateBuildConfiguration": "interactive"—— 改为"automatic"或直接删掉该项，让扩展强制同步 Maven 配置。
排除冲突依赖后，VSCode 仍加载旧版本 class？
这不是缓存问题，而是 VSCode 默认使用 m2e-style 的 classpath 构建策略：它把每个模块当作独立单元加载，不会主动合并或覆盖已加载的 jar。最稳妥的做法是切断“隐式共享”：
- 在出问题的子模块中，对冲突依赖显式添加
<exclusions></exclusions>，例如排除低版本spring-core：<exclusion><groupid>org.springframework</groupid><artifactid>spring-core</artifactid></exclusion>
- 不要依赖
<dependencymanagement></dependencymanagement>中的版本声明来“统一”，JDT.LS 不解析该块；必须在实际<dependency></dependency>中写死<version></version>； - 若使用 Spring Boot，禁用
spring-boot-dependencies的 BOM 自动导入（通过<dependencymanagement></dependencymanagement>覆盖），否则 VSCode 可能优先加载 BOM 声明的旧版而非你显式写的版本。
真正麻烦的从来不是写对 pom.xml，而是让 VSCode 的语言服务器相信你写对了——它不看你的意图，只认本地仓库里的 jar 和 pom 中白纸黑字的坐标。
