Eclipse中Gradle依赖为何从‘Project and External Dependencies’移至‘Referenced Libraries’？

决定依赖归属的核心因素 #

• Gradle项目关联状态：Eclipse项目必须正确关联Gradle构建工具（即带有Gradle Nature）。如果.project文件中缺失Gradle相关的nature配置，Eclipse会将依赖当作普通外部JAR，归入Referenced Libraries；正确关联的项目，依赖由Gradle插件统一管理，会显示在Project and External Dependencies下。
• Gradle Eclipse插件配置/版本：build.gradle中eclipse插件的classpath配置（比如自定义依赖范围、输出目录），或是插件版本的变更，都可能改变依赖的展示归类。另外，插件是否正常执行同步逻辑也会影响结果。
• Eclipse本地配置文件损坏：项目根目录下的.classpath、.project，或是.settings目录中的Gradle相关配置文件（如org.eclipse.buildship.core.prefs）损坏，会导致Eclipse无法识别Gradle的依赖管理关系，降级为普通引用。
• 依赖导入方式异常：如果手动添加过依赖，或是Gradle同步时出现错误（如依赖下载失败、缓存损坏），未被Gradle插件正确处理的依赖会被归入Referenced Libraries。

针对你问题的解决步骤 #

• 重新关联Gradle项目：右键项目 → 配置 → 转换为Gradle项目（若该选项存在，说明之前关联失效）。
• 重置项目配置文件：删除项目下的.project、.classpath和.settings目录，然后通过Eclipse重新导入项目：文件 → 导入 → Gradle → 现有Gradle项目，选择项目根目录完成导入。
• 检查build.gradle配置：确认没有修改Eclipse classpath的特殊配置，比如避免类似以下可能干扰依赖归类的代码：

  eclipse {
    classpath {
      defaultOutputDir = file('build/custom-classes')
    }
  }
  

• 清理Gradle缓存：删除本地Gradle缓存目录（Linux/macOS为~/.gradle/caches，Windows为C:\Users\<你的用户名>\.gradle\caches），然后执行gradle eclipse命令，再重新导入项目。

内容的提问来源于stack exchange，提问作者Gaetan L.