从 thumbnails.libretro.com 下载的缩略图不显示怎么办?

缩略图不显示，绝大多数情况不是图片坏了，而是文件名、平台目录名、存放路径这三处对不上。thumbnails.libretro.com 是一个按平台分目录的缩略图仓库，目录名形如 Nintendo - Game Boy/、Sega - Mega Drive - Genesis/，图片本身按 RetroArch 的命名约定组织。前端（RetroArch 或基于它的前端）在显示缩略图时，是按“平台标识 + ROM 文件名”去拼路径查找的，任何一环不匹配就会显示空白或默认图标。

先确认你下的是哪一类缩略图

RetroArch 的缩略图按用途分几种，混用会导致不显示：

  • Named_Boxarts：盒装封面
  • Named_Snaps：游戏内截图
  • Named_Titles：标题画面

下载时要把对应类型的文件夹整个放进缩略图根目录，而不是把图片直接堆在根目录。如果前端设置里勾选的是 Boxarts，而你只放了 Snaps，同样不会显示。

排查步骤

1. 核对平台目录名

打开 thumbnails.libretro.com 的目录列表，找到你玩的平台，记下它的完整目录名，例如：

  • Nintendo - Game Boy/
  • Nintendo - Game Boy Advance/
  • Nintendo - Nintendo 64/
  • Sony - PlayStation/

注意目录名里的空格、连字符、大小写。前端认的是这套标准名，如果你自己改成 GB、gba 之类的简写，就找不到了。

2. 核对图片文件名与 ROM 文件名

这是最常见的失败点。缩略图文件名必须和 ROM 文件名完全一致，只把扩展名换成图片格式。例如：

ROM 文件 对应缩略图
Super Mario Land (World).gb Super Mario Land (World).png
Sonic (USA).md Sonic (USA).png

容易踩的坑：

  • ROM 名里带 (USA)、(Rev 1)、[!] 这类标记，缩略图名必须一字不差地带上。
  • 你本地 ROM 被改过名（去掉了地区标记、加了中文），而缩略图还是原始名，就对不上。
  • 大小写：部分前端在 Linux 下区分大小写，Sonic 和 sonic 是两个文件。

验证方法：把 ROM 文件名复制下来，去掉扩展名，加上 .png，看是否和缩略图文件名逐字符相同。

3. 确认存放路径

缩略图要放在前端指定的缩略图根目录下，结构通常是：

thumbnails/
  Nintendo - Game Boy/
    Named_Boxarts/
      Super Mario Land (World).png
    Named_Snaps/
      Super Mario Land (World).png

如果平台目录或类型目录少了一层，或者多套了一层，前端就扫不到。RetroArch 的默认缩略图目录可以在设置里查看，确认你放的位置和它一致。

4. 刷新游戏列表并开启显示

文件放对后，前端不会自动重扫。需要：

  1. 在设置里确认缩略图显示选项已开启（对应 Boxarts / Snaps / Titles）。
  2. 重新加载或刷新游戏列表，让前端重新读取缩略图路径。
  3. 如果仍不显示，重启一次前端。

快速自查清单

  • [ ] 平台目录名与网站上的完全一致（含空格和连字符）
  • [ ] 图片放在 Named_Boxarts / Named_Snaps / Named_Titles 对应子目录
  • [ ] 图片文件名 = ROM 文件名（去扩展名）+ 图片扩展名，逐字符相同
  • [ ] 前端缩略图类型设置与下载的类型一致
  • [ ] 已刷新游戏列表或重启前端

还是不行怎么办

如果以上都对仍不显示，问题往往出在 ROM 名本身：很多 ROM 集用的是 No-Intro 或 Redump 的规范命名，而缩略图仓库也按这套命名，两者本应匹配。若你的 ROM 来自其他来源、命名不规范，最省事的做法是把 ROM 改名去匹配缩略图，而不是反过来改缩略图——因为缩略图数量多，改 ROM 名工作量更小。改完后记得刷新列表。

thumbnails.libretro.com