Android Studio无报错也不显示布局预览，已尝试Invalidate Caches/Restart无效

我在使用Android Studio开发时遇到布局文件无法显示预览的问题，界面未抛出任何错误或警告提示。我已经尝试执行Invalidate Caches/ Restart操作排查，但问题仍未解决。

问题界面截图如下：

XML文件代码： #

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:fitsSystemWindows="true"
tools:context=".MainActivity">

<RelativeLayout
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:paddingLeft="@dimen/activity_horizontal_margin"
    android:paddingRight="@dimen/activity_horizontal_margin"
    android:paddingTop="@dimen/activity_vertical_margin"
    android:paddingBottom="@dimen/activity_vertical_margin"
    app:layout_behavior="@string/appbar_scrolling_view_behavior"
    tools:showIn="@layout/activity_main"
    tools:context=".MainActivity">
    
    <ListView
        android:id="@+id/peripherals_list"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

    <TextView android:id="@+id/peripheral_list_empty"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:text="@string/peripheral_list_empty"/>

</RelativeLayout>

</androidx.constraintlayout.widget.ConstraintLayout>

解决方案 #

• 检查依赖版本适配
  优先确认项目build.gradle中constraintlayout依赖的版本是否与compileSdk版本匹配，避免使用alpha、beta等测试版依赖，推荐使用官方稳定版，示例配置如下：

  implementation 'androidx.constraintlayout:constraintlayout:2.1.4'
  

  调整版本后重新同步项目再查看预览即可。

• 验证引用资源是否存在
  当前布局中引用了@dimen/activity_horizontal_margin、@dimen/activity_vertical_margin、@string/peripheral_list_empty、@string/appbar_scrolling_view_behavior四个资源，若这些资源未在res/values对应目录下定义，会出现预览无报错但无法渲染的情况。可先将这些引用替换为硬编码值测试，比如将padding改为16dp、text改为测试文本，确认是资源问题后补全缺失资源即可。

• 调整预览配置参数
  打开布局预览面板右上角的配置下拉栏，更换为更低的稳定版API版本（如API 31/32），同时将预览主题切换为系统自带的MaterialComponents主题，排除自定义主题适配问题导致的渲染失败。

• 清理全量构建缓存
  除了执行Invalidate Caches/Restart外，再依次点击顶部菜单栏Build > Clean Project、Build > Rebuild Project，全量清理本地构建缓存后重新加载布局。

• 简化布局嵌套结构
  当前布局为ConstraintLayout嵌套RelativeLayout，且RelativeLayout添加了tools:showIn="@layout/activity_main"属性，可先删除该属性测试，或者暂时简化嵌套结构，排除布局嵌套导致的渲染异常。

内容的提问来源于stack exchange，提问作者MD Jahid Hasan