Ryujinx 指南与故障排除

针对设置、常见错误和长期最佳实践的实用分步方案。

安装产品密钥与固件

  1. Dump prod.keys 与 title.keys from a Nintendo Switch you own using homebrew tools.
  2. Open Ryujinx, go to File, then Open Ryujinx Folder, 与 copy keys into the system folder.
  3. 或者使用 Tools 或 Actions 中的 Install 核心s（若您的构建提供）。
  4. 通过 Tools → Install Firmware 安装固件，选择 ZIP、文件夹或 XCI。
  5. Restart the emulator when prompted. Outdated keys cause RYU-0003 firmware parsing errors.

添加游戏文件夹

  1. 打开 Options → Settings → Game Directories。
  2. 点击 Add 并选择包含 .nsp、.xci 或 .nca 的文件夹。
  3. 点击 Apply 和 OK。库将自动重新扫描。
  4. 若未显示游戏，请确认已安装密钥且路径可读。

选择正确的图形后端

Open Options, Settings, Graphics. Try Vulkan first on modern GPUs. Switch to OpenGL if you see Vulkan initialization failures or missing vulkan-1.dll errors. macOS builds use Metal. Update GPU drivers before testing.

有声音的黑屏（NVIDIA）

禁用不兼容的叠加工具，清除着色器缓存，并确认已为该游戏安装固件。

提升 FPS 并减少卡顿

  • 在图形设置中启用异步着色器编译。
  • 首次启动让 PPTC 构建完成；会话中勿删除缓存文件夹。
  • 若 GPU 瓶颈则降低分辨率缩放；若 CPU 瓶颈则关闭后台应用。
  • Use Vulkan on Steam Deck Linux builds for best results.
  • 至少保留 8 GB 可用内存；建议系统 内存 16 GB。

配置控制器

  1. Options → Settings → Input，选择 Player 1。
  2. Pick your device: Xbox, DualSense, Pro Controller, or keyboard.
  3. 映射按钮、保存并在游戏中测试。在界面中使用 clear 解除绑定。

安装模组与 DLC

Right-click a title or use the manager to install NSP updates 与 DLC. Place RomFS or Exefs mods in the mod folder path shown in settings. Enable cheats from the per-game menu when supported.

杀毒软件警告说明

Heuristic scanners flag unknown emulators. Verify SHA-256 hashes, download from trusted release pages only, 与 avoid repacks. If you quarantined a good build, restore it after hash confirmation 与 add a folder exclusion.

常见问题快速参考

模拟器在 Windows 上无法打开

Install the latest .NET Desktop Runtime when prompted. Run from a normal user folder, not Program Files.

缺少密钥或哈希错误

Refresh prod.keys 与 title.keys from your console dump. Reinstall game updates if NCA verification fails.

游戏卡在 30 FPS

部分游戏设计上限制帧率。使用 VSync 和帧率限制；仅在游戏支持时取消限制，避免双倍速。

更新后崩溃

清除该游戏的着色器与 PPTC 缓存后重建。确认固件符合游戏要求。

最佳实践

  • 重大模拟器更新前备份存档。
  • Keep GPU drivers 与 Ryujinx builds current.
  • 仅在能接受偶尔倒退时使用 Canary。
  • 长时间游玩前请阅读兼容性列表中的每游戏说明。
下载