Android Studio预览页黑屏：使用TabLayout时预览异常但模拟器正常

以下是几个经过验证的可行方案，按优先级尝试：

• 清理Android Studio缓存并重启
  打开Android Studio，依次点击 File -> Invalidate Caches...，勾选「Clear file system cache and local history」，然后点击「Invalidate and Restart」。很多预览界面的异常都是缓存导致的，这一步能解决大部分问题。

• 切换预览的API版本
  在预览界面顶部的设备/API选择下拉框中，尝试切换到不同的API版本（比如从Android 14换成Android 13）。部分高版本API的预览渲染存在兼容性问题，切换到稳定版本可能恢复正常。

• 检查TabLayout的布局代码
  确认你的TabLayout配置是否完整，比如是否设置了必要的属性：

  app:tabTextColor="@color/unselected_tab_color"
  app:tabSelectedTextColor="@color/selected_tab_color"
  app:tabIndicatorColor="@color/tab_indicator_color"
  

  如果布局中使用了动态数据绑定（如DataBinding）或者自定义Tab布局，确保预览时能获取到默认值，避免因数据未初始化导致渲染失败。

• 禁用Instant Run功能
  进入 Settings -> Build, Execution, Deployment -> Instant Run，取消勾选「Enable Instant Run to hot swap code/resource changes on deploy」，然后重启Android Studio。Instant Run的优化机制有时会干扰预览渲染。

• 更新Android Studio及相关依赖
  检查Android Studio是否为最新版本（Help -> Check for Updates...），同时确保项目中Material Components库的版本是最新的，在build.gradle(Module level)中更新依赖：

  implementation 'com.google.android.material:material:1.11.0' // 替换为最新版本
  

  旧版本的Material库可能存在预览渲染的bug。

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