Android Studio导入GitHub外部库：SubsamplingScaleImageView无法引用问题

嗨，我来帮你排查这个SubsamplingScaleImageView引用失败的问题，这类库的导入踩坑我熟得很，咱们一步步来：

这是导入第三方库最容易翻车的环节，得仔细核对：

• 先看项目根目录的settings.gradle（新版Android Studio用这个管理仓库），有没有添加正确的仓库地址。如果是官方发布的库，mavenCentral基本够用；如果是GitHub私有库或者特定仓库，得额外配置：

  dependencyResolutionManagement {
      repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
      repositories {
          google()
          mavenCentral()
          // 如果库托管在GitHub Packages，要加这个，替换成作者的用户名和仓库名
          maven { url = uri("https://maven.pkg.github.com/[作者用户名]/[仓库名]") }
      }
  }
  

• 再检查app模块的build.gradle，依赖是否正确添加，版本号要和你想用的一致：

  dependencies {
      // 举个例子，替换成你实际要导入的版本
      implementation 'com.davemorrissey.labs:subsampling-scale-image-view:3.10.0'
  }
  

• 别忘了点一下右上角的Sync Now同步Gradle！如果同步时出现“找不到依赖”的报错，那大概率是仓库配置错了，或者版本号写错，也可能是网络问题导致依赖没下载下来。

很多人会直接复制XML里的全类名到代码里，但容易踩包名的坑：

• SubsamplingScaleImageView的正确包名是com.davemorrissey.labs.subscaleview.SubsamplingScaleImageView，你可以手动输入这个全类名，看看IDE能不能自动补全——如果能，说明库已经导入成功，只是之前的导入语句写错了。
• 比如Java代码里的正确导入：

  import com.davemorrissey.labs.subscaleview.SubsamplingScaleImageView;
  

  Kotlin代码里的正确导入：

  import com.davemorrissey.labs.subscaleview.SubsamplingScaleImageView
  

• 如果IDE还是标红，试试Invalidate Caches / Restart，AS的缓存经常抽风，这个操作能解决很多“明明配置对了但找不到类”的玄学问题。路径是：File -> Invalidate Caches... -> 选择Invalidate and Restart。

有时候Gradle同步提示成功，但实际依赖没下载下来：

• 你可以去项目的.gradle/caches/modules-2/files-2.1目录下，找有没有com.davemorrissey.labs相关的文件夹。如果没有，说明依赖没下载成功，得回头检查Gradle配置或者网络。
• 也可以在AS的Project视图切换到Android模式，看External Libraries里有没有这个库——如果没有，说明依赖根本没添加成功。

• 检查你的项目compileSdkVersion、targetSdkVersion是否和库的要求兼容。比如有些库要求compileSdk至少31，而你的项目用的是29，这时候可能会出现类无法识别的情况，需要调整项目的SDK版本。
• 如果项目里还有其他ImageView相关的第三方库，暂时移除它们试试，排除包名冲突的可能性（虽然这个情况比较少见，但万一呢）。

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