使用 homebrew 工具从您拥有的 Nintendo Switch 转储 prod.keys 与 title.keys。
Ryujinx 指南与故障排除
针对设置、常见错误和长期最佳实践的实用分步方案。
安装产品密钥与固件
打开 Ryujinx，进入 File → Open Ryujinx Folder，将密钥复制到 system 文件夹。
或若构建提供，使用 Tools 或 Actions → Install Keys。
通过 Tools → Install Firmware 安装固件，选择 ZIP、文件夹或 XCI。
按提示重启模拟器。过期密钥会导致 RYU-0003 固件解析错误。
添加游戏文件夹
打开 Options → Settings → Game Directories。
点击 Add 并选择包含 .nsp、.xci 或 .nca 的文件夹。
点击 Apply 和 OK。库将自动重新扫描。
若未显示游戏，请确认已安装密钥且路径可读。
选择正确的图形后端
打开 Options → Settings → Graphics。测试任何后端前请先更新 GPU 驱动。
Vulkan
在现代 NVIDIA 与 AMD GPU 上优先尝试。在 Windows 与 Linux 上性能与兼容性最佳。
推荐OpenGL
当 Vulkan 初始化失败或缺少 vulkan-1.dll 时的后备方案。
后备Metal
macOS 与 Apple Silicon 构建的默认后端，针对 Metal 硬件优化。
macOS提升 FPS 并减少卡顿
在图形设置中启用异步着色器编译。
首次启动让 PPTC 构建完成；会话中勿删除缓存文件夹。
若 GPU 瓶颈则降低分辨率缩放；若 CPU 瓶颈则关闭后台应用。
在 Steam Deck Linux 构建上优先使用 Vulkan 以获得最佳效果。
内存基线
至少保留 8 GB 可用内存；建议系统 16 GB RAM 以获得稳定性能。
配置控制器
打开 Options → Settings → Input 并选择 Player 1。
选择设备：Xbox、DualSense、Pro Controller 或键盘。
映射按钮、保存并在游戏中测试。在界面中使用 clear 解除绑定。
安装模组与 DLC
模组指南
DLC、更新与金手指
右键游戏或使用管理器安装 NSP 更新与 DLC。将 RomFS 或 Exefs 模组放入设置中显示的模组文件夹。在支持时从每游戏菜单启用金手指。
杀毒软件警告说明
启发式扫描可能标记未知模拟器。请验证 SHA-256，仅从可信发布页下载并避免重打包。若误隔离，在确认哈希后恢复并添加文件夹排除项。
常见问题快速参考
模拟器在 Windows 上无法打开
按提示安装最新 .NET Desktop Runtime。从普通用户文件夹运行，不要放在 Program Files。
缺少密钥或哈希错误
从主机转储刷新 prod.keys 与 title.keys。若 NCA 验证失败请重新安装游戏更新。
游戏卡在 30 FPS
部分游戏设计上限制帧率。使用 VSync 和帧率限制；仅在游戏支持时取消限制，避免双倍速。
更新后崩溃
清除该游戏的着色器与 PPTC 缓存后重建。确认固件符合游戏要求。
最佳实践
重大模拟器更新前备份存档。
保持 GPU 驱动与 Ryujinx 构建为最新版本。
仅在能接受偶尔倒退时使用 Canary。
长时间游玩前请阅读兼容性列表中的每游戏说明。