IntelliJ中Java（含Maven）项目报Package does not exist错误求助

为什么会出问题？ #

IDE（比如IDEA）会把本地仓库路径、依赖索引、路径宏定义都缓存起来，你删除或移动.m2/.gradle后，缓存里的旧路径和实际路径不匹配，就算做了mvn clean/install或者Invalidate Caches，也可能因为全局缓存没清干净、路径宏没更新导致问题残留。纯Java项目中招是因为IDE的全局索引和路径配置是所有项目共享的，全局配置乱了自然波及所有项目。

分步解决方案 #

• 彻底清理IDE全局缓存
  直接关闭IDE，找到IDE的系统目录（比如IDEA的是~/.IntelliJIdea<版本号>/system），删掉里面的caches、localHistory、indexes文件夹——别只依赖IDE里的Invalidate Caches按钮，手动删除更彻底。

• 修复path.macros.xml路径配置
  找到IDE配置目录下的path.macros.xml（比如IDEA的是~/.IntelliJIdea<版本号>/config/options/path.macros.xml），打开后检查MAVEN_REPOSITORY、GRADLE_USER_HOME这些变量的路径是否和你当前的.m2/.gradle实际位置一致，不对就修改，没有的话手动添加：

  <application>
    <component name="PathMacrosImpl">
      <macro name="MAVEN_REPOSITORY" value="/你的用户名/.m2/repository" />
      <macro name="GRADLE_USER_HOME" value="/你的用户名/.gradle" />
    </component>
  </application>
  

• 重新配置仓库并刷新项目
  打开IDE进入Settings（Mac为Preferences）：

  • Maven项目：到Build, Execution, Deployment → Build Tools → Maven，确认Maven home directory、User settings file、Local repository全是正确路径，然后右键项目选择Maven → Reload Project
  • Gradle项目：同理到Gradle配置页确认路径，右键选择Gradle → Reload Gradle Project
  • 纯Java项目：删掉项目根目录的.iml文件和.idea文件夹，重新导入项目，手动选对SDK，把缺失的依赖重新添加一遍

• 检查硬链接/权限问题
  如果之前给.m2/.gradle建过硬链接，现在路径变了就删掉旧链接，用ln命令重新建立正确的链接；另外确认本地仓库文件夹的权限正常，IDE能正常读写这些文件。

内容的提问来源于stack exchange，提问作者appmac