retroarch 中文文档 下载 App

常见问题排查 安装、核心、黑屏、存档、性能七大类

安装环节

症状排查
提示"没有权限安装应用"点弹窗里的设置按钮 → 打开对该文件管理器的"允许安装未知应用"授权
Play Protect 弹红色警告选"更多详情 → 仍要安装"；老系统上临时关闭 Play Protect 扫描
安装按钮点不动、转圈确认 APK 文件完整（重新下载）；清安装会话重试
点开图标闪退确认设备是 64 位；存储权限没给也会启动即崩

核心下载

症状排查
核心列表只有几十个装的是 Google Play 渠道旧版 → 换官网渠道重装
下载一直转圈、超时网络到 Libretro 服务器不稳 → 换网络重试
下载完但 Load Core 里没有重进 Main Menu → Load Core → Installed Core List 刷新

游戏加载黑屏 / 秒退

按这个顺序逐级排查（不要跳）：

  1. 对应主机的 Core 装了吗？ → 没装 Core 游戏起不来
  2. BIOS 文件对吗？ → 光驱类主机（PS1 部分游戏、Dreamcast、土星、世嘉 CD）缺 BIOS 就黑屏——核对文件名和 MD5
  3. ROM 文件完整吗？ → 解压到一半的文件、来源不明的压缩包是黑屏大户
  4. 换个 Core 试试 → 同主机可能有多个 Core，某个 Core 对这个游戏兼容性不好
  5. Core 版本过旧？ → Online Updater → Update Installed Cores

扫描不出游戏

症状排查
列表完全空先装 Core → Online Updater → Update Databases → 再扫
扫出来很少ROM 校验值对不上数据库 → 用 Manual Scan 放宽匹配
某些游戏一直未识别换 Manual Scan 指定主机类型跳过数据库匹配

存档问题

症状排查
游戏内存档丢了别用系统清理工具一键清应用数据；存档目录别放 Android/data 深处
即时存档读不出来和 Core 版本绑定 → Core 大版本更新后旧 .state 可能失效；改用 .srm 保底
自动存档进坏档Quick Menu 把自动加载关掉 → 用 .srm 回到好进度 → 重新进
存档位置找不到Settings → Directory → 看 Savefile / Savestate 指向

性能与画面

症状排查
游戏卡顿换高速核心 → 把内部分辨率调低 → 关着色器 → 设备开性能模式
画面被拉伸变形Quick Menu → Video → 手动调 Aspect Ratio + Integer Scaling
画面撕裂Video → Synchronization → 开 Vertical Synchronization
开 Shader 后帧率骤降减少 Shader Pass 层数，或换轻量预设（如 crt-pi）
音频卡顿、爆音Video → Synchronization → Audio Synchronization 开启；Buffer Size 调大

按键错乱

症状排查
外接手柄按键不对Settings → Input → Auto Config 重新自动配置；个别键不对进 Quick Menu → Controls 手动改
菜单确认/取消反了Settings → Input → Menu Controls → Menu Swap OK & Cancel Buttons
游戏内按键和其他游戏不一致Quick Menu → Controls → 改完 Save Game Remap File（否则下一款游戏又回到全局）
快捷键触发不了先按住 Hotkey Enable（L1 或 Select）再按功能键

其他常见问题

症状排查
RetroAchievements 成就不弹确认当次会话联网；Core 是否在成就支持列表里；登录令牌过期重填
联机大厅刷不出换网络；大厅服务器临时不可用稍等再试
倒带不工作Settings → Frame Throttle → Rewind → Enable Rewind 打开；Core 必须支持序列化
截图 / 录像没反应快捷键正确触发了吗？截图默认 F8、录像默认 F9（可改）；输出目录有写入权限吗

最终手段

以上都试过还解决不了：