如何彻底移除Gradle旧实现？解决依赖别名无效报错

• 先检查版本配置文件
  报错核心是版本目录（libs.versions.toml）里的别名无效，哪怕你在app模块的build.gradle.kts里删了依赖，只要这个文件里有错误的别名配置，Gradle还是会报错。

  • 打开项目根目录的libs.versions.toml，找有没有androidx-material3-window-size-class-android相关的配置，直接删掉。
  • 正确的配置应该对应androidx.compose.material3:material3-window-size-class，示例：

    [versions]
    material3WindowSizeClass = "1.2.0" # 替换成最新稳定版本号
    
    [libraries]
    androidx-material3-window-size-class = { group = "androidx.compose.material3", name = "material3-window-size-class", version.ref = "material3WindowSizeClass" }
    

• 彻底清理Gradle缓存
  光靠IDE的清除缓存可能不够，用命令行彻底刷新依赖：

  • Windows：执行 gradlew clean build --refresh-dependencies
  • Mac/Linux：执行 ./gradlew clean build --refresh-dependencies
  • 还可以手动删除本地Gradle缓存目录（~/.gradle/caches 或 C:\Users\<你的用户名>\.gradle\caches），删完重启IDE再同步。

• 修正依赖写法
  你提到的Reply项目用的是androidx.compose.material3:material3-window-size-class，这个才是正确的依赖坐标，带-android后缀的依赖大概率是不存在的拼写错误。

  • 用版本目录的写法：implementation(libs.androidx.material3.window.size.class)
  • 直接写坐标的写法：implementation("androidx.compose.material3:material3-window-size-class:1.2.0")

• 关于新建项目
  先把上面的步骤都试一遍，大概率能解决问题。真要新建项目的话，先对比新旧项目的Gradle配置文件（比如根目录的build.gradle.kts、settings.gradle.kts、libs.versions.toml），找出差异点再迁移代码，没必要直接复制所有内容。

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