RecyclerView中ImageView运行时不渲染设计视图可正常显示

安全阿岳

2026-10-4

问题根因

你遇到的预览正常、运行无图片的核心问题是布局中给AppCompatImageView配置图片时用了tools命名空间：

tools:background="@drawable/ic_baseline_cloud_download_24"

tools命名空间下的所有属性仅在Android Studio的设计预览阶段生效，应用编译运行时这类属性会被完全忽略，所以运行时不会加载对应的drawable资源。

修复方法

你可以根据需求选择以下任意一种方案修改：

方案1：保留背景设置的方式

新增android:前缀的background属性，保证运行时也能加载资源，tools前缀的属性可以保留用于预览调试：

<androidx.appcompat.widget.AppCompatImageView
    android:elevation="2dp"
    android:id="@+id/imageb"
    android:layout_width="50dp"
    android:layout_height="50dp"
    cardView:layout_constraintBottom_toBottomOf="parent"
    cardView:layout_constraintEnd_toEndOf="parent"
    cardView:layout_constraintTop_toTopOf="parent"
    android:background="@drawable/ic_baseline_cloud_download_24"
    tools:background="@drawable/ic_baseline_cloud_download_24" />

方案2：使用ImageView专属的src属性（更推荐）

ImageView原生用于展示图片资源，使用android:src属性比设置background更适合图标展示场景，还可以配合scaleType调整图片缩放规则：

<androidx.appcompat.widget.AppCompatImageView
    android:elevation="2dp"
    android:id="@+id/imageb"
    android:layout_width="50dp"
    android:layout_height="50dp"
    cardView:layout_constraintBottom_toBottomOf="parent"
    cardView:layout_constraintEnd_toEndOf="parent"
    cardView:layout_constraintTop_toTopOf="parent"
    android:src="@drawable/ic_baseline_cloud_download_24"
    android:scaleType="centerInside" />