更新Android Studio后XML布局可视化设计界面不显示该如何解决？

架构老林

2026-9-27

XML布局预览异常截图

解决方案

检查AGP版本与Android Studio版本兼容性：如果是更新Android Studio大版本后出现的问题，同步升级项目根目录build.gradle中的Android Gradle Plugin版本到和IDE匹配的正式版本，项目同步完成后重新打开布局文件查看。
清空IDE缓存后重启：点击顶部菜单栏 File → Invalidate Caches...，勾选清空文件缓存和本地历史、清空VFS日志两个选项，点击Invalidate and Restart等待IDE重启完成后再打开项目。
排查布局内异常组件：临时注释掉布局内的自定义View、第三方UI组件，测试基础原生组件能否正常渲染，若可以则定位到对应组件，升级对应依赖版本或者修复组件的预览适配代码。
调整预览API版本：点击布局编辑器右上角的API版本选择下拉框，切换为更低的稳定API版本（如当前选择API 34可切换为API 33），重新触发渲染。
删除本地构建缓存：关闭Android Studio，手动删除项目根目录下的.gradle、.idea、build文件夹，以及各子模块目录下的build文件夹，重新打开IDE等待项目同步完成即可。