Android Studio设计时视图自定义Sample Data图片不显示问题求助

别担心，我帮你一步步排查搞定这个问题：

1. 先确认Sample Data目录的识别状态 #

首先得确保你创建的Sample Data目录已经被Android Studio标记为Sample Data根目录，不然AS不会把它当成预览资源目录处理：

• 右键点击你的Sample Data目录
• 选择 Mark Directory as -> Sample Data Root

2. 检查目录结构是否规范 #

你的文件结构要放在项目根目录下（不是res文件夹里），大致应该是这样：

你的项目根目录/
  ├─ app/
  ├─ Sample Data/
  │  ├─ 你的JSON数据文件（比如category_data.json）
  │  └─ categories/
  │     ├─ food.png
  │     └─ travel.png
  └─ ...

确保图片文件夹categories和你的JSON文件处于同一层级，这样路径引用才不会出错。

3. 修正JSON里的图片路径引用 #

在你的JSON数据中，图片字段要使用相对路径指向图片文件，注意文件名和大小写要和实际文件完全一致（AS的Sample Data对大小写敏感）：

[
  {
    "title": "美食分类",
    "image": "categories/food.png"
  },
  {
    "title": "旅行分类",
    "image": "categories/travel.png"
  }
]

4. 正确绑定ImageView的Sample Data #

在RecyclerView的item布局中，用tools:src（如果是矢量图可以用tools:srcCompat）绑定JSON里的图片字段，同时确保已经关联了Sample Data数据源：

<ImageView
    android:id="@+id/category_img"
    android:layout_width="80dp"
    android:layout_height="80dp"
    tools:src="@{item.image}"
    tools:context=".adapter.CategoryAdapter"/>

如果用了Data Binding，记得布局根标签要加<layout>，并正确引入数据变量。

5. 清理AS缓存（终极修复） #

有时候Android Studio的缓存会导致预览不更新，这时候可以：

• 点击顶部菜单栏 File -> Invalidate Caches...
• 勾选 Invalidate and Restart，等待AS重启
  重启后再打开Layout Designer，应该就能看到自定义的图片占位资源了。

另外也可以检查下图片文件本身是否正常，比如有没有损坏、是不是标准PNG格式，这些小细节也可能影响预览。

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