Jetpack Compose 预览(Preview)不显示是一个常见问题,可能由多种原因导致。以下是系统的调试技巧和解决方案:
1. 检查基础配置
-
Compose 版本兼容性
确保compose-compiler
、compose-ui
等依赖版本一致且与 Kotlin 版本兼容。检查build.gradle
:android {compileOptions {sourceCompatibility JavaVersion.VERSION_17targetCompatibility JavaVersion.VERSION_17}kotlinOptions {jvmTarget = "17"} } dependencies {implementation 'androidx.compose.ui:ui:1.5.4'implementation 'androidx.compose.material3:material3:1.1.2'debugImplementation 'androidx.compose.ui:ui-tooling:1.5.4'// 确保启用预览支持implementation 'androidx.compose.ui:ui-tooling-preview:1.5.4' }
-
启用 Compose 支持
确认项目build.gradle
中启用 Compose:android {buildFeatures {compose true} }
2. 代码相关问题
-
检查
@Preview
注解
确保预览函数正确添加注解并指定唯一名称:@Preview(name = "Light Mode", showBackground = true) @Preview(name = "Dark Mode", uiMode = Configuration.UI_MODE_NIGHT_YES) @Co