Ryujinx 使用指南:在 PC 上运行 Switch 游戏的完整步骤

Ryujinx 使用指南:在 PC 上运行 Switch 游戏的完整步骤

【免费下载链接】Ryujinx用 C# 编写的实验性 Nintendo Switch 模拟器项目地址: https://gitcode.com/GitHub_Trending/ry/Ryujinx

Ryujinx 是一款用 C# 编写的开源 Nintendo Switch 模拟器,让你在电脑里运行 .xci 和 .nsp 格式的 Switch 游戏。截至 2024 年 5 月,项目已测试约 4,300 款游戏,其中 4,100 多款可启动进入游戏,约 3,550 款达到可玩水平。如果你的电脑满足下面第一条硬件门槛,且拥有自己合法购买的游戏文件,按本文步骤操作,你可以完成从安装、配置到日常使用的全过程。

全文按任务顺序展开:先跑起来,再调配置,再装手柄,最后处理常见故障。

一、Ryujinx 环境要求与首次启动步骤

内存 8 GiB 是官方给出的硬性要求,低于这个值会出现卡顿甚至崩溃。

有两条路径可以拿到可执行程序:

路径 A:直接下载预编译版(最快)

1. 从官方发布渠道下载对应系统的压缩包
2. 解压到不含中文的路径,例如D:\Ryujinx
3. 双击可执行文件启动

路径 B:从源码编译

1. 安装 .NET 8.0 或更高版本的 SDK,global.json 中要求的版本号为 8.0.100
2. 克隆仓库:git clone https://gitcode.com/GitHub_Trending/ry/Ryujinx
3. 在项目目录执行:dotnet build -c Release -o build
4. 运行build目录里的可执行文件

首次启动做四件事:

1. 启动程序,它会自动在用户目录下创建 Ryujinx 主文件夹
2. 点击文件→打开 Ryujinx 文件夹,确认文件夹位置
3. 把系统文件(从你自己的 Switch 设备提取)放入该目录
4. 点击文件→加载游戏,选择 .xci 或 .nsp 文件进入游戏

首次启动时前几分钟明显卡顿属于正常现象,原因和处理方法见第四节第 2 条。

二、Switch 模拟器关键配置:够用档与进阶档

进入路径:选项→设置→图形,对应界面定义在 SettingsGraphicsView.axaml。

够用档(默认即可,低配电脑保持这档)

• 渲染后端:Vulkan(驱动支持时自动可选)
• 分辨率缩放:原生(Native)
• 抗锯齿:关闭(None)
• 磁盘着色器缓存:保持开启

进阶档(高配电脑按需打开)

• 分辨率缩放:2x、3x、4x 或自定义(0.1~100 倍可调)
• 缩放滤镜:双线性、最近邻或 FSR
• 抗锯齿:FXAA 或 SMAA(Low 到 Ultra 四档)
• 各向异性过滤、画面宽高比调整

系统选项卡里两项值得改的设置

• 内存管理:三种模式定义在 MemoryManagerMode.cs——软件页表(最慢但兼容性最好)、主机映射(快)、主机映射无检查(最快,默认)。遇到奇怪的不兼容行为时,切换到软件页表再试
• 持久化翻译缓存:默认开启。把同一款游戏启动到标题画面至少两次,第三次启动起加载速度明显提升,缓存建好后永久生效

音频方面,输出完全支持,麦克风输入不支持。后端默认使用 OpenAL,有杂音或延迟时在设置里切换为 SDL2 试试。

三、控制器连接与按键映射

1. 先连接手柄,再启动模拟器——识别率更高
2. 支持键盘、鼠标、触摸、JoyCon 以及几乎所有常见手柄;双 JoyCon 体感需要 DS4Windows 或 BetterJoy 这类工具辅助
3. 点击选项→设置→输入,选择玩家槽位和设备,逐个映射按键后保存
4. 所有设置最终写入用户文件夹下的Config.json,需要精细调整时可以直接编辑这个文件

四、Ryujinx 常见故障现象与处理办法

现象 1:游戏启动后黑屏,或根本没进游戏

原因:显卡驱动过旧,或当前渲染后端在你的 GPU 上不可用。

解决:更新显卡驱动到最新版 → 在图形设置里把后端切换为 Vulkan 或 OpenGL → 重启模拟器;仍然黑屏就把内存管理模式改为软件页表再试。

现象 2:首次启动特别慢、全程卡顿

原因:持久化翻译缓存还没建立,这是设计内的正常表现,不是故障。

解决:把游戏连续两次启动到标题画面即可,第三次起加载时间会大幅下降,之后无需再额外启动。

现象 3:游戏中途掉帧、出现着色器卡顿

原因:分辨率缩放倍数过高或抗锯齿占用太多 GPU。

解决:分辨率缩放改回 Native → 抗锯齿改为 None → 确认磁盘着色器缓存处于开启状态。

现象 4:手柄插入后识别不到

原因:手柄在模拟器启动之后才插入,或该设备从未做过映射。

解决:拔掉手柄重新插入并确认系统已识别 → 再启动模拟器 → 进入输入设置页重新映射按键。

现象 5:程序打不开,提示缺少运行时

原因:电脑没有安装 .NET 8.0 运行时,版本以 global.json 为准。

解决:安装 .NET 8.0 运行时后重新打开。

五、DLC、Mod 与存档备份等进阶操作

• DLC 管理:右键游戏 → 管理附加内容,添加合法的 .nsp 文件,支持多个版本并存。
• Mod 加载:右键游戏 → 打开 Mod 目录,放入 romfs、exefs 或运行时修改(如金手指)三类 Mod 均可;动手前先备份原始游戏文件。
• 存档位置:用户目录 Ryujinx 文件夹下的bis/user/save,定期把整个目录复制到安全位置,恢复时原样放回即可。
• 日志排查:遇到无法启动的问题,先在设置里调整日志详细程度,再对照日志定位报错位置。
• 本地多人:本地无线(LDN)联机有单独的专用构建版,按官方指南另行部署。

以上覆盖了从安装到日常使用 Ryujinx Switch 模拟器的全部主线,更多面向贡献者的资料见 官方文档,核心模拟代码位于 src/Ryujinx/。下一步:打开模拟器,加载一款你合法拥有的游戏,按第二节的"够用档"完成第一局完整游玩。

【免费下载链接】Ryujinx用 C# 编写的实验性 Nintendo Switch 模拟器项目地址: https://gitcode.com/GitHub_Trending/ry/Ryujinx