Android Studio旧项目XML布局预览空白，求解决方案

可行排查修复步骤 #

• 切换预览API版本：在Android Studio布局预览面板顶部，选择与项目targetSdkVersion匹配或更低的API等级，部分旧布局在高版本API预览环境下会出现兼容性黑屏。
• 排查自定义View问题：若布局内使用了自定义View，先临时注释掉相关代码测试预览是否恢复。如果是自定义View导致，检查其onMeasure、onDraw方法是否有缺失的必要逻辑，或添加@SuppressLint("MissingSuperCall")确保生命周期方法调用正确。
• 替换测试主题：打开AndroidManifest.xml，将Activity的自定义主题临时替换为系统默认主题（如Theme.MaterialComponents.Light.DarkActionBar），旧主题可能存在预览渲染不兼容的情况。
• 手动清理预览缓存：删除Android Studio的缓存目录后重启软件，不同系统路径如下：
  • Windows：C:\Users\<你的用户名>\.AndroidStudio<版本号>\system\caches
  • Mac：~/Library/Caches/Google/AndroidStudio<版本号>
  • Linux：~/.cache/Google/AndroidStudio<版本号>
• 检查XML隐藏语法错误：切换到布局文件的Code标签，逐行检查是否存在未闭合标签、无效属性值等问题，这类问题可能不会触发编译报错，但会导致预览失败。
• 降级Android Studio版本：若以上方法均无效，尝试使用项目创建时期对应的Android Studio版本（比如3年前的4.x/5.x版本），新版IDE对旧项目的预览支持可能存在兼容性缺陷。

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