版本提示:不同 IDEA 版本的菜单名称与位置存在差异,部分版本已将“重新导入”并入 Reload All Maven Projects,需要更彻底清理时可使用 File > Invalidate Caches;以下内容基于仍区分两个入口的版本。

1. 同步所有Maven项目(Reload All Maven Projects)

作用

  1. 读取当前所有模块 pom.xml,解析依赖、模块结构、插件、版本、scope;
  2. 拉取/更新本地Maven仓库的Jar包索引,同步pom新增/删除的依赖;
  3. 刷新模块目录结构(新增子模块、resource资源路径、编译输出目录);
  4. 更新Feign接口、DTO、二方包内的类/方法索引;
  5. 识别pom里的Maven插件配置(mybatis、spring-boot、feign插件)。

适用场景

  • 修改pom.xml(新增依赖、改版本、删依赖)
  • 本地install了更新后的二方包(如system-api新增接口)
  • 新增/删除项目子模块
  • 代码报“找不到类/方法”(二方包更新后)

2. 重新加载所有Maven项目(Reimport / 重新导入)

作用

  1. 完全清空IDEA本地缓存的Maven模型,丢弃旧pom解析记录;
  2. 重新从磁盘读取全部pom、递归解析父子依赖、dependencyManagement;
  3. 重置Maven配置(settings.xml私服、镜像、本地仓库路径);
  4. 修复pom冲突、版本错乱、依赖识别异常;
  5. 重置模块JDK、编译输出路径、scope作用域识别异常。

适用场景

  1. 单纯“同步刷新”后依赖依旧爆红、找不到方法;
  2. pom存在重复依赖、版本冲突、Maven警告异常;
  3. 切换分支后pom大量变更,索引残留旧代码;
  4. 修改了maven的settings.xml私服/仓库地址;
  5. 手动删除过本地.m2仓库jar包。

两者核心区别

功能 同步所有Maven项目(刷新) 重新加载所有Maven项目(重新导入)
缓存处理 增量更新,保留部分旧缓存 全量清空Maven缓存,完全重新解析
执行速度 快(秒级) 慢(多模块项目几十秒)
解决轻度问题 pom新增依赖、二方包更新找不到类 依赖错乱、版本冲突、刷新无效、分支切换残留缓存

常见问题处置

现象 常见原因 处理方式
编译报 JDK 版本不匹配 IDEA 的 Project SDK 与 POM 中编译版本不一致 统一 Project SDK、Language Level 与 maven.compiler 配置
依赖标红且无法下载 镜像或私服配置未生效、网络不可达 核对 help:effective-settings,重新加载 Maven 项目
本地仓库已有构件仍提示找不到 IDEA 索引未更新 执行重新加载所有 Maven 项目,必要时清理缓存
源码中文乱码 文件编码与 project.build.sourceEncoding 不一致 统一 UTF-8,检查 IDE 文件编码设置
子模块未被识别 父 POM 未聚合该模块,或 relativePath 指向错误 检查 <modules> 与父 POM 路径
修改 settings.xml 后无变化 IDE 未重新加载 Maven 配置 重新加载所有 Maven 项目,确认镜像与认证生效