无法解析依赖de.hdodenhof:circleimageview:2.4.0 求解决方案

这种依赖解析失败的情况我在开发中碰到过好多次，别着急，咱们一步步排查解决：

• 第一步：确认依赖声明的位置和写法
  首先要确保你是在模块级的build.gradle（一般是app/build.gradle）里添加的依赖，而不是项目根目录的配置文件。正确的依赖写法应该是：

  dependencies {
      implementation 'de.hdodenhof:circleimageview:2.4.0'
  }
  

  别写错了包名或版本号，2.4.0是这个库的稳定版本，是存在的。

• 第二步：检查仓库配置是否正确
  依赖需要从远程仓库拉取，所以得确认你的项目配置了正确的仓库：

  • 如果你用的是Android Studio Arctic Fox及以上版本，仓库配置在settings.gradle里，需要包含mavenCentral（或者归档的jcenter，不过优先用前者）：

    dependencyResolutionManagement {
        repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
        repositories {
            google()
            mavenCentral()
            // jcenter() // 若mavenCentral拉取不到，可临时添加，jcenter虽归档但旧版本包仍可访问
        }
    }
    

  • 旧版本Android Studio的话，仓库配置在项目根目录的build.gradle的allprojects块里，同样要确保包含上述仓库。

• 第三步：同步项目+清理缓存
  写完配置后，点击Android Studio右上角的「Sync Project with Gradle Files」按钮同步项目。如果还是报错，大概率是缓存问题：
  点击顶部菜单栏的File → Invalidate Caches...，选择「Invalidate and Restart」，等Studio重启后再同步一次，很多时候这就能解决问题。

• 第四步：排查网络/代理问题
  如果是在公司内网或者使用代理环境，可能是网络限制导致拉取不到依赖。可以尝试切换到个人热点，或者检查代理设置：File → Settings → Appearance & Behavior → System Settings → HTTP Proxy，确认代理配置正确，或者暂时关闭代理试试。

• 第五步：手动导入AAR包（终极方案）
  要是以上方法都不行，就手动下载AAR包导入项目：

  1. 找到circleimageview:2.4.0的AAR包，下载后放到app/libs目录下；
  2. 在模块级build.gradle里添加本地依赖：

     dependencies {
         implementation files('libs/circleimageview-2.4.0.aar')
     }
     

  3. 再次同步项目即可。

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