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