更新Android Studio Canary后Jetpack Compose预览功能失效

• 校验版本适配关系
• 确认当前Android Studio Canary版本与所使用的Jetpack Compose Beta版本完全配套，跨大版本混搭（过旧的Canary运行新版Compose Beta、未适配的新Canary运行旧版Compose）会直接导致IDE无法识别预览入口
• 核对项目中的AGP插件版本、Compose Compiler版本一一对应，版本错配是预览失效的最常见诱因
• 排查@Preview注解的有效性
• 确认被@Preview修饰的Composable函数为无参、所有参数带默认值的独立函数，依赖外部注入（如ViewModel、Context实例）、无默认参数的Composable会被IDE判定为无法生成预览
• 避免使用自定义封装的Preview别名注解，该阶段Canary版本对这类自定义注解的识别存在已知Bug
• 重置IDE预览模块状态
• 触发全量缓存清除重启：执行File > Invalidate Caches... > Invalidate and Restart操作，清除旧索引缓存，让IDE重新扫描项目内的@Preview标记
• 恢复布局编辑器默认配置：进入Settings > Tools > Layout Editor路径，点击恢复默认设置，还原被隐藏的「显示预览」「显示代码」切换按钮
• 检查Preview面板停靠状态：如果预览面板被误拖拽移出编辑区，可通过View > Tool Windows > Preview路径重新调出，停靠在代码编辑区侧栏
• 检查项目配置阻断项
• 确认对应模块的build.gradle中已开启Compose特性支持：配置buildFeatures { compose true }并正确引入全量Compose依赖，未开启Compose支持的模块，IDE会直接忽略模块内的所有@Preview注解
• 确认当前选中的运行配置为Android应用类型：如果切换到纯JVM测试、NDK构建等非应用类运行配置，IDE会自动隐藏所有Compose预览相关入口按钮
• 完成配置修改后执行一次全量Gradle同步，避免旧配置残留导致IDE识别异常

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