RetroArch 缩略图不显示按故障链路分级修复的完整排查流程【免费下载链接】RetroArchCross-platform, sophisticated frontend for the libretro API. Licensed GPLv3.项目地址: https://gitcode.com/GitHub_Trending/re/RetroArch进菜单后常见的三种现象游戏列表整列是纯色占位图或只显示部分条目有图某一条目以前有图现在没了但同名图片仍在磁盘上列表滚动时图片闪一下又变回占位图本文沿触发 → 传导 → 表现的链路定位断点再按 30 秒 / 5 分钟 / 深度三档给出修复动作最后用 5 条可观察标准确认生效。通读约 5 分钟动手 5 到 15 分钟。故障链路问题从哪一环开始RetroArch 的菜单缩略图不是读一张图而是一条查找链条目命名 → 依次拼出候选文件名 → 在 thumbnails 目录下按类型子目录Named_BoxArt、Named_Snaps、Named_Titles 等取图 → 解码渲染。链路实现见 gfx/gfx_thumbnail.c查找所用的命名标志全名 / 标准名 / 短名定义在 playlist.h。1.16.0 起查找顺序为ROM 名称 → 数据库名称 → 短名称的灵活匹配并在 1.16.0.2 增加了按播放列表 ROM 文件名查找的选项CHANGES.md#L687。1.17.0 修复了 Ozone 下缩略图栏缺失、全屏浏览闪烁等问题CHANGES.md#L702。也就是说图片存在 ≠ 会被找到文件名断链、设置错档、或旧版本自身的显示 bug都会让链路在某一环终止最终表现就是占位图。条目命名缺失 ── 候选文件名不命中 ── 占位图/空框 │ │ ▼ ▼ 数据库名不匹配 按需下载未开启或构建无网络支持 └──────── 持续无图按成本分级修复30 秒档核对显示设置与按需下载操作打开设置 用户界面 菜单检查图标缩略图类型是否为你已有图片所属的类型如 BoxArt 与 Title 不是同一类若开着设置 网络下的按需缩略图下载On-Demand Thumbnail Downloads先关掉——该设置官方描述对性能有严重影响settings/settings_def_network_ondemand_thumbnails.h。预期现象类型选对后原本被隐藏的图片立即出现在列表关闭按需下载后滚动不再出现闪一下又变回占位图。无效时的备选如果用的是 Ozone 主题且缩略图栏整条缺失先确认版本——该问题属于 1.17.0 修复范围CHANGES.md#L702升级后复测仍在旧版上则临时换 XMB 主题验证是否主题相关。5 分钟档对齐文件名与目录操作确认图片位于用户目录thumbnails/下对应系统名的子目录如Named_BoxArt/且文件名按候选顺序之一存在ROM 全名不含扩展名、数据库标准名、短名。对Super Mario Bros. (USA).nes三个候选名依次是Super Mario Bros. (USA)、Super Mario Bros.、smb。格式不限 PNG——1.20.0 起支持 jpg/jpeg、bmp、tgaCHANGES.md#L467。若图片以 ROM 文件名命名却仍不显示在 1.16.0.2 及以上版本把播放列表的缩略图查找方式切到按播放列表 ROM 文件名对应 1.16.0.2 的选项CHANGES.md#L687。预期现象重命名后无需重启切换一次列表焦点即可见图。无效时的备选核对路径是否指向用户配置目录下的thumbnailsconfig 中为thumbnails_directory见 configuration.c云同步开启时确认缩略图目录未被同步规则排除。深度档清理陈旧缓存与版本对齐操作删除 thumbnails 下与已不存在游戏对应的陈旧文件包括 savestate 缩略图——1.20.0 起回收存档时才会连带清理缩略图CHANGES.md#L468旧版本会留死图同时确认版本 ≥ 1.16.0.2避免命中Load Content 加载的内容在历史记录里永远无图这类已修复缺陷CHANGES.md#L698。预期现象删除后占位图位置不再出现指向已删除文件的残图。无效时的备选1.16.0 起内置的旧版缩略图包下载器已移除CHANGES.md#L700升级后自动补图不再发生属正常行为缩略图包需要自行准备并放入对应系统目录。验证确认修复生效播放列表全量滚动一遍无纯色占位格或仅无图条目保留占位用加载内容直接运行一个游戏回菜单看历史记录条目带图验证 1.16.0.2 修复点同一游戏分别用 XMB 与 Ozone 主题查看两侧显示一致重命名一张缩略图使三种候选名全部失效条目应变回占位图——恢复文件名后图应回来证明查找链而非缓存残留重启 RetroArch以上现象不变说明结果来自磁盘文件而非一次性内存状态长期维护版本更新优先跟进带缩略图修复的版本1.16.0.2、1.17.0、1.20.0 的 MENU 条目见 CHANGES.md新增游戏后按ROM 全名 → 标准名 → 短名优先级放置图片别依赖单一命名关闭按需下载除非在慢速网络下也接受其性能开销启用存档回收时确认缩略图一并被清理1.20.0 起生效以上五档之外仍无图时把设置 调试下日志开启后的输出连同你的 RetroArch 版本、菜单主题、一条具体游戏名提交到项目的 issue 或 RetroArch 官方论坛附上占位图截图定位最快。【免费下载链接】RetroArchCross-platform, sophisticated frontend for the libretro API. Licensed GPLv3.项目地址: https://gitcode.com/GitHub_Trending/re/RetroArch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 RetroArch 缩略图不显示：按故障链路分级修复的完整排查流程
RetroArch 缩略图不显示按故障链路分级修复的完整排查流程【免费下载链接】RetroArchCross-platform, sophisticated frontend for the libretro API. Licensed GPLv3.项目地址: https://gitcode.com/GitHub_Trending/re/RetroArch进菜单后常见的三种现象游戏列表整列是纯色占位图或只显示部分条目有图某一条目以前有图现在没了但同名图片仍在磁盘上列表滚动时图片闪一下又变回占位图本文沿触发 → 传导 → 表现的链路定位断点再按 30 秒 / 5 分钟 / 深度三档给出修复动作最后用 5 条可观察标准确认生效。通读约 5 分钟动手 5 到 15 分钟。故障链路问题从哪一环开始RetroArch 的菜单缩略图不是读一张图而是一条查找链条目命名 → 依次拼出候选文件名 → 在 thumbnails 目录下按类型子目录Named_BoxArt、Named_Snaps、Named_Titles 等取图 → 解码渲染。链路实现见 gfx/gfx_thumbnail.c查找所用的命名标志全名 / 标准名 / 短名定义在 playlist.h。1.16.0 起查找顺序为ROM 名称 → 数据库名称 → 短名称的灵活匹配并在 1.16.0.2 增加了按播放列表 ROM 文件名查找的选项CHANGES.md#L687。1.17.0 修复了 Ozone 下缩略图栏缺失、全屏浏览闪烁等问题CHANGES.md#L702。也就是说图片存在 ≠ 会被找到文件名断链、设置错档、或旧版本自身的显示 bug都会让链路在某一环终止最终表现就是占位图。条目命名缺失 ── 候选文件名不命中 ── 占位图/空框 │ │ ▼ ▼ 数据库名不匹配 按需下载未开启或构建无网络支持 └──────── 持续无图按成本分级修复30 秒档核对显示设置与按需下载操作打开设置 用户界面 菜单检查图标缩略图类型是否为你已有图片所属的类型如 BoxArt 与 Title 不是同一类若开着设置 网络下的按需缩略图下载On-Demand Thumbnail Downloads先关掉——该设置官方描述对性能有严重影响settings/settings_def_network_ondemand_thumbnails.h。预期现象类型选对后原本被隐藏的图片立即出现在列表关闭按需下载后滚动不再出现闪一下又变回占位图。无效时的备选如果用的是 Ozone 主题且缩略图栏整条缺失先确认版本——该问题属于 1.17.0 修复范围CHANGES.md#L702升级后复测仍在旧版上则临时换 XMB 主题验证是否主题相关。5 分钟档对齐文件名与目录操作确认图片位于用户目录thumbnails/下对应系统名的子目录如Named_BoxArt/且文件名按候选顺序之一存在ROM 全名不含扩展名、数据库标准名、短名。对Super Mario Bros. (USA).nes三个候选名依次是Super Mario Bros. (USA)、Super Mario Bros.、smb。格式不限 PNG——1.20.0 起支持 jpg/jpeg、bmp、tgaCHANGES.md#L467。若图片以 ROM 文件名命名却仍不显示在 1.16.0.2 及以上版本把播放列表的缩略图查找方式切到按播放列表 ROM 文件名对应 1.16.0.2 的选项CHANGES.md#L687。预期现象重命名后无需重启切换一次列表焦点即可见图。无效时的备选核对路径是否指向用户配置目录下的thumbnailsconfig 中为thumbnails_directory见 configuration.c云同步开启时确认缩略图目录未被同步规则排除。深度档清理陈旧缓存与版本对齐操作删除 thumbnails 下与已不存在游戏对应的陈旧文件包括 savestate 缩略图——1.20.0 起回收存档时才会连带清理缩略图CHANGES.md#L468旧版本会留死图同时确认版本 ≥ 1.16.0.2避免命中Load Content 加载的内容在历史记录里永远无图这类已修复缺陷CHANGES.md#L698。预期现象删除后占位图位置不再出现指向已删除文件的残图。无效时的备选1.16.0 起内置的旧版缩略图包下载器已移除CHANGES.md#L700升级后自动补图不再发生属正常行为缩略图包需要自行准备并放入对应系统目录。验证确认修复生效播放列表全量滚动一遍无纯色占位格或仅无图条目保留占位用加载内容直接运行一个游戏回菜单看历史记录条目带图验证 1.16.0.2 修复点同一游戏分别用 XMB 与 Ozone 主题查看两侧显示一致重命名一张缩略图使三种候选名全部失效条目应变回占位图——恢复文件名后图应回来证明查找链而非缓存残留重启 RetroArch以上现象不变说明结果来自磁盘文件而非一次性内存状态长期维护版本更新优先跟进带缩略图修复的版本1.16.0.2、1.17.0、1.20.0 的 MENU 条目见 CHANGES.md新增游戏后按ROM 全名 → 标准名 → 短名优先级放置图片别依赖单一命名关闭按需下载除非在慢速网络下也接受其性能开销启用存档回收时确认缩略图一并被清理1.20.0 起生效以上五档之外仍无图时把设置 调试下日志开启后的输出连同你的 RetroArch 版本、菜单主题、一条具体游戏名提交到项目的 issue 或 RetroArch 官方论坛附上占位图截图定位最快。【免费下载链接】RetroArchCross-platform, sophisticated frontend for the libretro API. Licensed GPLv3.项目地址: https://gitcode.com/GitHub_Trending/re/RetroArch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考