别再瞎猜了RetroArch 缩略图不显示10 分钟找回你的游戏封面【免费下载链接】RetroArchCross-platform, sophisticated frontend for the libretro API. Licensed GPLv3.项目地址: https://gitcode.com/GitHub_Trending/re/RetroArch打开 RetroArch 的游戏列表本该一排游戏封面的位置全是黑色方块或者灰色占位图。用加载内容启动的游戏在历史记录里永远没有封面而从列表进入的游戏却正常。如果你正卡在这个画面这篇 RetroArch 缩略图不显示的排查指南能帮你 10 分钟内定位原因并修复全程只需改文件名、动两个菜单选项外加一条命令。 快速诊断先定位再动手先花一分钟对号入座。下表覆盖最常见的四种症状确认自己属于哪一类再跳到对应章节。你看到的症状最可能的原因30 秒验证动作列表全是黑色占位图缩略图目录不存在或路径对不上检查用户目录下有没有thumbnails/文件夹只有加载内容启动的游戏没图历史记录不记录封面路径靠名字匹配手动找一张图按 ROM 文件名改名放进对应目录图片明明在文件夹里却不显示文件名与 ROM 不匹配或缓存里存着旧结果把图片改名为和 ROM 完全一致不含扩展名能显示但发灰、发黑、像蒙了一层图片格式或尺寸不合适调色板抖动叠加用系统看图工具打开原图确认能正常显示 分场景修复场景一整列都是黑色占位图检查先确认用户目录Linux 默认~/.config/retroarchWindows 默认%APPDATA%\RetroArch下存在thumbnails文件夹且内部按主机分好了子目录。操作把封面图按Named_Boxarts封面、Named_Snaps截图、Named_Titles标题三个子目录存放一级目录名与主机名一致。如果整包封面还没有可以克隆官方封面库例如 NES 的封面包git clone https://gitcode.com/GitHub_Trending/re/RetroArch/../libretro-thumbnails/Nintendo_-_Nintendo_Entertainment_System.git验证重启 RetroArch回到列表滚动查看。修复成功的标志是占位图全部消失换成你放进文件夹里的图片。场景二只有部分游戏没图且都是加载内容进来的检查这类游戏走历史记录入口记录里不带封面路径系统只能拿游戏名去thumbnails里猜。名字对不上图就永远找不到。操作把图片改名为和 ROM 文件完全一致、去掉扩展名比如Super Mario Bros. (USA).nes对应Super Mario Bros. (USA).png。改名后如果菜单没反应去设置 → 用户 → 保存 → 清除缓存然后重启。验证重新进入列表。修复成功的标志是该游戏的位置出现了正确封面且不再需要重启才生效。场景三能显示但发灰、发黑、像蒙了一层检查先排除图片本身的问题——用系统自带看图工具打开原图打不开或显示异常就先修图。能打开的话多半是格式或尺寸问题。操作优先使用 JPG、PNG、BMP 格式封面用 1:1 正方形尺寸最稳妥。老菜单主题调色板有限可在设置 → 界面 → RGUI → 缩略图抖动里切换开关试试。验证对比原图。修复成功的标志是菜单里的图不再整体偏暗比例没有被拉扁或拉宽。 为什么会这样底层机制RetroArch 展示封面时是按路径 → 文件名 → 短名的顺序逐级匹配图片命中一次就会记进缓存。新版本的匹配规则比旧版更灵活但也意味着改名、换目录后缓存里还留着上次找到的旧路径。它不报错只是默默不刷新——这就是文件明明在图就是不出现的根源。匹配逻辑的入口在gfx/gfx_thumbnail.c规则变更记录可查项目根目录CHANGES.md中 1.16.0 的版本说明。最后提醒两句改过 ROM 文件名或搬过缩略图目录记得清一次缓存再重启否则旧路径会一直挂在缓存里。封面文件名和 ROM 完全一致不含扩展名永远是最稳的写法比研究匹配规则省事得多。延伸资源封面包总仓库libretro-thumbnails官方手册中缩略图相关章节RetroArch Wiki - Thumbnails项目内缩略图渲染实现gfx/gfx_thumbnail.c【免费下载链接】RetroArchCross-platform, sophisticated frontend for the libretro API. Licensed GPLv3.项目地址: https://gitcode.com/GitHub_Trending/re/RetroArch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考