Android Studio添加lifecycle viewModel至build.gradle.kts报错未解析

问题场景 #

• 环境：已安装最新版Android Studio，所有组件均为最新状态
• 操作：尝试在build.gradle.kts的依赖中添加ViewModel，当前依赖配置如下：

dependencies {
    implementation(libs.androidx.core.ktx)
    implementation(libs.androidx.lifecycle.runtime.ktx)
    implementation(libs.androidx.activity.compose)
    implementation(platform(libs.androidx.compose.bom))
    implementation(libs.androidx.ui)
    implementation(libs.androidx.ui.graphics)
    implementation(libs.androidx.ui.tooling.preview)
    implementation(libs.androidx.material3)
    implementation(libs.androidx.lifecycle.viewmodel.ktx)
    androidTestImplementation(libs.androidx.junit)
    androidTestImplementation(libs.androidx.espresso.core)
    androidTestImplementation(platform(libs.androidx.compose.bom))
    androidTestImplementation(libs.androidx.ui.test.junit4)
    debugImplementation(libs.androidx.ui.tooling)
    debugImplementation(libs.androidx.ui.test.manifest)
}

• 错误信息：

failed
- Download info
- build.gradle.kts
- Unresolved reference: viewmodel

• 复现步骤：创建空Activity新项目，添加implementation(libs.androidx.lifecycle.viewmodel.ktx)依赖后触发问题

解决方法 #

方法1：完善版本目录（Version Catalog）配置 #

错误核心是libs.androidx.lifecycle.viewmodel.ktx这个引用在项目的版本配置文件中未定义，需要补充配置：

1. 打开项目根目录下的gradle/libs.versions.toml文件
2. 在[versions]块中添加ViewModel KTX的版本号（以当前稳定版为例）：

   [versions]
   # 保留原有其他版本配置
   lifecycle = "2.6.2"
   

3. 在[libraries]块中添加对应的库引用：

   [libraries]
   # 保留原有其他库配置
   androidx.lifecycle.viewmodel.ktx = { module = "androidx.lifecycle:lifecycle-viewmodel-ktx", version.ref = "lifecycle" }
   

4. 点击Android Studio右上角的Sync Now按钮同步Gradle项目

方法2：直接使用硬编码依赖（快速临时方案） #

如果不想修改版本目录配置，可直接替换为完整的依赖坐标：

// 替换原有的implementation(libs.androidx.lifecycle.viewmodel.ktx)
implementation("androidx.lifecycle:lifecycle-viewmodel-ktx:2.6.2")

同步项目后即可解决错误

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