Android Studio中ViewModel导入失败及依赖配置问题求助

问题情况 #

• 用最新版Android Studio开发时，导入ViewModel一直报错
• 发现build.gradle.kts中缺少ViewModel依赖，添加依赖并声明版本后仍无法正常导入
• 尝试手动编写导入语句，触发了Compose异常，导致代码开发停滞

一步步解决 #

1. 配准依赖 #

在模块级的build.gradle.kts中，确保添加正确的ViewModel依赖，若使用Compose需额外添加适配依赖：

// 基础ViewModel核心依赖
implementation("androidx.lifecycle:lifecycle-viewmodel-ktx:2.8.4")
// Compose项目必须添加，保证ViewModel与Compose适配
implementation("androidx.lifecycle:lifecycle-viewmodel-compose:2.8.4")

版本号建议使用当前稳定版，可通过Android Studio的Dependencies面板查看最新兼容版本

2. 同步并清理项目 #

• 点击右上角的Sync Project with Gradle Files按钮，完成依赖同步
• 依次执行Build > Clean Project、Build > Rebuild Project，清除旧编译缓存

3. 使用正确的导入语句 #

不要手动编写错误的导入路径，标准导入语句如下：

import androidx.lifecycle.ViewModel
// 若用到ViewModel协程功能，追加此导入
import androidx.lifecycle.viewModelScope

若使用Compose中的ViewModel扩展方法，需导入：

import androidx.lifecycle.viewmodel.compose.viewModel

4. 排查Compose异常 #

添加依赖后若出现Compose异常，检查以下两点：

• Compose版本与ViewModel版本需配套，建议使用官方推荐的对应版本
• 模块级build.gradle.kts中Compose编译选项需与Kotlin版本匹配：

composeOptions {
    kotlinCompilerExtensionVersion = "1.5.14" // 此版本需与项目Kotlin版本对应
}

额外排查方向 #

• 检查根目录settings.gradle.kts是否配置了Google、MavenCentral仓库，缺少仓库会导致依赖无法下载
• 重启Android Studio，部分缓存问题会导致依赖识别异常

内容的提问来源于stack exchange，提问作者Rishav Kumar Shrivastava