如何修复现有项目中Jetpack Compose的@Preview预览失效问题？

针对现有项目添加Compose后预览空白的问题，核心是项目Compose相关配置不完整，以下是必须补充的配置项：

1. 根目录build.gradle/build.gradle.kts配置 #

确保引入匹配版本的Kotlin Android插件：

plugins {
    id 'com.android.application' version '对应Android Gradle插件版本' apply false
    id 'org.jetbrains.kotlin.android' version '对应Kotlin版本' apply false
}

注：Android Gradle插件、Kotlin版本、Compose Compiler版本必须相互兼容，可参考官方版本对应规则

2. 模块级build.gradle/build.gradle.kts配置 #

启用Compose构建特性 #

在android代码块中添加：

android {
    // 其他原有配置...
    buildFeatures {
        compose true
    }
    composeOptions {
        kotlinCompilerExtensionVersion = "与Kotlin版本匹配的Compose Compiler版本"
    }
}

添加Compose核心依赖 #

在dependencies代码块中补充：

dependencies {
    // Compose基础UI库
    implementation "androidx.compose.ui:ui:对应版本"
    implementation "androidx.compose.material:material:对应版本"
    // 预览功能依赖
    implementation "androidx.compose.ui:ui-tooling-preview:对应版本"
    debugImplementation "androidx.compose.ui:ui-tooling:对应版本"
}

3. 错误截图内容翻译 #

你附加的错误截图内容翻译如下：

预览加载失败：
无法初始化Compose预览环境，请检查项目是否已正确配置Compose Tooling依赖，同时确认Kotlin版本与Compose Compiler版本的兼容性，版本不匹配会导致预览无法正常生成。

完成以上配置后，同步项目并重新构建，Compose预览即可正常显示。

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