Ryujinx Switch模拟器完整教程：从零到跑起游戏的日常使用指南

Ryujinx Switch模拟器完整教程：从零到跑起游戏的日常使用指南

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

想在电脑上运行 Switch 游戏，却不知从哪一步开始？这篇 Ryujinx Switch 模拟器指南会带着你走完"判断配置 → 装好程序 → 装固件 → 载入游戏 → 备份存档"的完整链路，最后停在"你已能日常玩起自己拥有的游戏、遇到卡顿知道怎么排查"这个节点。全程跟着菜单点即可，不需要懂代码。

先判断：值不值得上

Ryujinx 是一个用 C# 编写的开源 Nintendo Switch 模拟器，MIT 许可，核心能力分四块：CPU 侧的 ARMeilleure 把 ARM 指令翻译成 x86 代码执行，GPU 侧模拟 Switch 的 Maxwell 显卡，音频与键盘/鼠标/手柄输入也有完整支持（源码结构可看 docs/README.md 中的项目说明）。

对照下面四条，全中就可以开工：

• 内存 ≥ 8GiB。低于这个值官方明确提示可能出现体验不佳或崩溃（README.md）
• 显卡满足其一：支持 Vulkan 且驱动为最新版、支持 OpenGL 4.5、或 macOS 走 Metal（经 MoltenVK）
• 系统是 Windows / macOS / Linux 之一
• 只打算从源码构建的话：额外需要 .NET 8.0+ SDK，且版本不低于 global.json 中写的 8.0.100

一句结论：截至 2024 年 5 月，项目已测试约 4,300 款游戏，其中约 3,550 款被认为可正常游玩——主力机型上这是"值得上"的选择；如果你的显卡连 Vulkan 都不支持且内存只有 4GiB，先别急着装。

第一次跑通

获取程序，二选一。

• 直接下构建包：从 Ryujinx 官方下载渠道拿对应系统的最新构建，解压即用，适合绝大多数人。
• 从源码构建：适合想边玩边改的开发者。先装好 .NET 8 SDK，然后执行两条命令就够：

git clone https://gitcode.com/GitHub_Trending/ry/Ryujinx
cd Ryujinx && dotnet build -c Release -o build

产物全部在新建的 build 目录里（步骤与 README.md 的 Building 一节一致）。

首次打开，做三件事。

1. 启动程序，确认主窗口正常显示，顶部菜单栏能看到 File、Options、Tools 三个菜单
2. 点 File → Open Ryujinx Folder，系统会打开数据目录——配置文件 Config.json、系统文件、存档都归拢在这里，以后所有"东西去哪找"都以它为起点
3. 展开 File 菜单，确认存在 Load Application From File、Load Unpacked Game；展开 Tools 菜单，确认存在 Install Firmware

这一步做对的标志：Open Ryujinx Folder 确实弹出了一个装有配置文件的文件夹，且菜单项与上面描述一致。到这里程序本体就算就绪，剩下的按你的目标走分支。

按你的目标选路

下面三条分支不是固定顺序，哪个目标先卡住就先走哪条；一般首次使用按 A → B → C 顺序各走一遍。

分支 A：目标是"游戏能启动"——先装固件

Switch 游戏依赖系统固件文件，Ryujinx 不自带，需要你自己准备（XCI 或 ZIP 格式的固件包）。

1. File 或 Tools 菜单 → Install Firmware → Install a firmware from XCI or ZIP；固件若是目录形式，选 Install a firmware from a directory
2. 选中固件包，等待安装完成

判断成功的信号：主界面底部状态栏出现 System Version: …（文案见 en_US.json 中的 StatusBarSystemVersion）。没有这一行，后面载入游戏都会失败。

分支 B：目标是"把游戏放进库里跑起来"

1. 把游戏文件放到一个固定目录，比如 Games 文件夹
2. Options → Settings → User Interface 选项卡，在 Game Directories 区域点 Add，选入这个目录——之后该目录会被自动扫描，游戏直接出现在列表里
3. 不想进列表的话，也可以随时 File → Load Application From File 直接打开单个文件，或 Load Unpacked Game 打开已解压的游戏目录
4. 在游戏列表中双击目标游戏

你会看到：画面经历一段系统开机过程后进入游戏的标题界面。第一次慢是正常的，原因和加速办法在下一节讲。

分支 C：目标是"存档别丢"

1. 在游戏列表里右键目标游戏
2. 选 Open User Save Directory
3. 直接复制整个打开的文件夹到安全位置

这一步做对的标志：文件管理器中打开了一个以 16 位十六进制存档 ID 命名的文件夹，里面的就是该游戏的全部进度数据。路径规则在 src/Ryujinx/Common/ApplicationHelper.cs 里可以核实：user/save/{存档ID}，位于数据目录的 NAND 分区下。

把它调到顺手

只挑最常碰的三处，都在 Options → Settings 里，界面定义见 SettingsGraphicsView.axaml 与 SettingsSystemView.axaml。

1. Graphics API（Graphics 选项卡） 默认值：Vulkan，绝大多数情况不用动。 何时才动：只有你的显卡不支持 Vulkan、而支持 OpenGL 4.5 时，才切到 OpenGL。 怎么动：Backend 下拉框选 OpenGL 即可；Vulkan 路径下多出的着色器编译更快，整体表现更好。

2. Resolution Scale（Graphics 选项卡） 默认值：Native (720p/1080p)，即 Switch 原始渲染分辨率。 何时才动：显卡余力充足、想要更锐利画面时。 怎么动：下拉选 2x 或 3x，游戏运行中改完点 Apply 即可对比效果。官方提示词写得很直白——"4x 对几乎任何配置都过头了"（见 en_US.json 的 ResolutionScaleTooltip），别一上来就拉满。

3. PPTC 翻译缓存（System 选项卡） 默认值：开启（PPTC (Profiled Persistent Translation Cache) 复选框），官方建议"不确定就保持开启"。 何时才动：基本不用动它；它的作用是把已翻译好的函数缓存下来，避免每次启动重新翻译。 关键规则：同一游戏至少要跑到标题界面两次，第三次启动起加载提速才生效，且此后永久生效（README.md Features 一节明确写了这一点）。

顺带一提：System 选项卡的 Memory Manager Mode 默认是 Host Unchecked (fastest, unsafe)，提示词同样写着"不确定就保持默认"，非专业人员不要改。

卡住时先看这里

按"先猜原因、再给一个动作"的思路排查：

• 启动后长时间转圈才进标题画面 先怀疑：PPTC 缓存还没生效——前两次启动本来就处于全量翻译期。 动作只有一个：别改任何设置，把同一游戏跑到标题界面两次以上，第三次再对比加载时长。

• Linux 下启动时弹窗提示 vm.max_map_count 过低 先怀疑：内核允许的内存映射数量不够，超过上限模拟器会直接崩溃（弹窗原文见 en_US.json）。 动作：按弹窗提示选择临时提高（重启失效）或永久提高；也可以安装 pkexec，让 Ryujinx 帮你自动处理这项调整。

• 报 "No applications found in selected file." 先怀疑：你选中的不是有效的游戏文件——格式不对、文件不完整或已损坏。 动作：换一个完整的原始文件重试；如果文件本身没问题，改用 Load Unpacked Game 指向解压后的目录加载。

• 游戏能进但卡死、闪退或画面异常 先怀疑三件事，按概率排查：固件没装好 → 该游戏着色器缓存损坏 → 游戏与当前构建版本不兼容。 动作：先确认状态栏有 System Version；再右键游戏 → Cache Management → Purge Shader Cache 后重试；还不行就去官方兼容性列表查这款游戏当前的已知状态。右键菜单里另有 Queue PPTC Rebuild，可在下次启动时重建翻译缓存，适合翻译缓存本身出问题时使用。

红线与底线

• 只运行你自己拥有正版的游戏，固件从自己购买的实体机导出，Ryujinx 不提供这些文件
• 不传播游戏、固件、存档等任何受版权保护的内容
• 图形增强、DLC、Mod 等功能仅用于你拥有相应授权的内容
• 模拟器本身从官方渠道获取，别用来源不明的修改版
• 软件基于 MIT 许可，第三方依赖清单见 distribution/legal/THIRDPARTY.md

从这里继续

• 下一步实操：从官方兼容性列表挑一款标记为可玩的游戏，完整跑两次以上让 PPTC 生效，直观感受加载提速；然后按显卡性能把 Resolution Scale 从 Native 逐步往上调，找到画质与帧率的平衡点。
• 想深入原理：从 docs/README.md 入手了解项目文档索引，CONTRIBUTING.md 覆盖贡献流程，docs/coding-guidelines/coding-style.md 是 C# 代码风格规范。
• 日常入口：平时用得最多的就是 Settings 里 Graphics 与 System 两个选项卡、游戏右键菜单的 Cache Management，以及 Open Ryujinx Folder 这一个数据目录入口。

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