企业官网建设流程全解析

在 PC 上运行 Switch 游戏：Ryujinx 模拟器入门到日常使用指南

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

Ryujinx 是一款用 C# 编写的开源 Nintendo Switch 模拟器，目标是让 Switch 游戏在 Windows、macOS 和 Linux 上运行。它可以模拟 Switch 的 CPU、GPU、音频和输入设备，支持 OpenGL、Vulkan 等图形接口。本文带你走完几件事：完成系统准备并获取模拟器、安装固件并加载第一个游戏、跑通图形与 CPU 的常用设置、处理存档和常见问题。

项目速览：Ryujinx 是什么，适合谁

Ryujinx 从 2017 年 9 月开始开发，由 gdkchan 创建，代码仓库采用 MIT 许可证。它不是"能跑就行"的实验品，仓库 README 中给出的数据是：截至 2024 年 5 月，项目已测试约 4,300 个游戏，其中 4,100 多个能进入游戏画面，约 3,550 个被认为可正常游玩。

它的核心能力分四块：CPU 模拟器 ARMeilleure 负责把 ARM 指令翻译成 x86 代码并做优化；GPU 部分模拟 Switch 的 Maxwell 架构显卡，支持 OpenGL 4.5、Vulkan，macOS 上通过 MoltenVK 使用 Metal；音频输出完整支持，通过 SDL2 实现，OpenAL 和 libsoundio 作为后备；输入方面支持键盘、鼠标、手柄和体感。

它适合两类人：想在自己电脑上玩 Switch 游戏的玩家，以及想研究模拟器实现原理的开发者——仓库内 docs 目录和大量源码注释可以直接作为学习材料。

准备工作：系统要求、获取方式与首次启动

这一节解决"我的电脑能不能跑、程序从哪来、第一次打开能看到什么"的问题。

先对照下面的清单确认达标情况：

• 内存至少 8GiB，低于这个数值可能出现卡顿或崩溃（README 的明确说明）
• 显卡满足以下任一条：支持 OpenGL 4.5，或支持 Vulkan 且驱动为最新版，或 macOS 使用 Metal
• 操作系统为 Windows、macOS 或 Linux 之一
• 如果要从源码构建，额外需要 .NET 8.0 或更高版本的 SDK，且版本不低于 global.json 中指定的版本

获取模拟器有两条路径：

1. 从源码构建：执行git clone https://gitcode.com/GitHub_Trending/ry/Ryujinx，进入项目目录后运行dotnet build -c Release -o build，产物会出现在新建的build目录中
2. 直接使用官方构建的发布包解压运行（官方渠道信息见 README.md）

首次启动后的检查动作：

1. 打开模拟器主界面，确认窗口正常显示，顶部菜单栏包含 File、Options、Tools 等菜单
2. 点击 File 菜单下的Open Ryujinx Folder，系统会打开模拟器的数据目录，里面存放配置文件和后续的系统文件
3. 打开 File 菜单，确认能看到Load Application From File、Install a firmware from XCI or ZIP等条目

到这里你应该看到：模拟器主窗口正常打开，且通过Open Ryujinx Folder能定位到一个包含配置文件的文件夹。

核心用法：按任务走通完整流程

任务一：安装固件

这一步解决"游戏能启动"的前提——Switch 游戏依赖系统固件文件，Ryujinx 不自带这些文件，需要你自备后通过模拟器安装。

1. 准备好从实体机导出的固件包（XCI 或 ZIP 格式）
2. 打开 File 菜单，选择Install a firmware from XCI or ZIP；如果你的固件是目录形式，选择Install a firmware from a directory
3. 等待安装完成

完成后你应该看到：主界面状态栏显示System Version，表示固件已生效。没有这一步，加载游戏会因缺少系统文件而失败。

任务二：加载第一个游戏

这一步解决"把游戏放进模拟器并运行"的问题。支持单个游戏文件和已解压的游戏目录两种方式。

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

完成后你应该看到：游戏开始加载，画面经过系统开机过程后进入游戏标题界面。第一次加载较慢属于正常现象，后面的进阶部分会解释缓存机制。

任务三：备份一份游戏存档

这一步解决"进度数据安全"的问题。

1. 在游戏列表中选中某个游戏，点击鼠标右键
2. 选择Cache Management旁边的Open User Save Directory
3. 系统会打开该游戏的存档文件夹，路径位于数据目录的bis文件夹下（见 ApplicationHelper.cs 中的user/save/{存档ID}结构）
4. 直接复制整个文件夹到安全位置

完成后你应该看到：文件管理器中打开了一个以十六进制存档 ID 命名的文件夹，里面就是这个游戏的存档数据。

进阶与调优：图形、CPU 缓存与音频

这一节只展开三个最常调整的部分，其余能力（DLC 管理、标题更新、Mod 目录、Amiibo、LDN 本地联机）都在界面上有入口，遇到再查官方文档即可。

图形设置：后端选择和分辨率

入口是 Options 菜单 →Settings→ Graphics 选项卡（界面定义见 SettingsGraphicsView.axaml）：

• Graphics API：设置项的提示文字说明，不确定就选 Vulkan，它对所有现代显卡综合表现更好且着色器编译更快；只有在不支持 Vulkan 的老显卡或低显存场景才用 OpenGL
• Resolution Scale：原生 720p/1080p 起步，可选 2x、3x，4x 标注了"不建议"，按显卡性能往下调
• 其他增强项包括Enable Shader Cache（着色器缓存）、Anisotropic Filtering（各向异性过滤，Auto 到 16x）、宽高比调整，以及 FSR 等缩放滤镜（README 中列出的六项图形增强）

CPU 缓存：把加载时间降下来

Ryujinx 默认开启 Profiled Persistent Translation Cache（PPTC），作用是把已翻译好的函数缓存起来，避免每次启动都重新翻译。规则在 README 中写得很明确：游戏需要至少运行两次到标题界面或更深处，第三次启动起才能享受加载提速，之后的提升是永久性的。

两个相关操作：

1. 在游戏右键菜单的Cache Management中，可以Queue PPTC Rebuild（下次启动时重建翻译缓存）或Purge Shader Cache（删除该游戏的着色器缓存），卡顿时这是第一手排查工具
2. 内存管理模式在 Settings 的 System 选项卡中，有 Software、Host (fast)、Host Unchecked (fastest) 三档，默认使用 Host Unchecked，不建议非专业人员改动

音频与输入

音频输出走 SDL2，OpenAL 和 libsoundio 是后备后端，Settings 的 Audio 选项卡可切换；麦克风输入目前不支持（README 明确说明）。输入支持键盘、鼠标、触摸和几乎所有手柄，双 JoyCon 体感在 Windows 上需要 DS4Windows 或 BetterJoy 辅助，所有映射都在输入配置菜单里完成。

问题速查

现象：游戏启动后转圈很久才进标题画面。最可能原因：PPTC 缓存还没生效，前两次启动本来就要全量翻译。解决动作：正常等待，把同一游戏运行到标题界面两次以上，从第三次开始加载会明显变快。

现象：Linux 下启动时弹窗提示vm.max_map_count过低。最可能原因：系统允许的内核内存映射数量达不到游戏要求，超过上限模拟器会直接崩溃。解决动作：按弹窗提示选择临时提高（重启后失效）或永久提高；也可以在设置中允许 Ryujinx 通过pkexec辅助处理（提示文案见 en_US.json）。

现象：加载游戏时报 "No applications found in selected file"。最可能原因：选中的文件不是有效的游戏文件（不是 XCI/NSO/NSP 等支持格式，或文件损坏）。解决动作：换用完整的原始文件重试，或改用Load Unpacked Game指向解压后的目录。

现象：游戏能启动但卡死或闪退。最可能原因：缺固件、存档损坏，或该游戏与当前构建版本不兼容。解决动作：先确认System Version已正常显示，再删除该游戏的缓存（右键 →Cache Management→Purge Shader Cache）后重试，仍不行就查阅官方兼容性列表确认该游戏的已知状态。

使用边界

• 只运行你自己拥有的游戏，固件文件需要从自己购买的实体机中导出，Ryujinx 不提供这些文件
• 不要分发游戏、固件或存档等受版权保护的内容
• 图形增强、DLC 和 Mod 功能仅用于你拥有相应授权的内容
• 从官方渠道获取模拟器，避免来路不明的修改版
• 本软件基于 MIT 许可证，第三方依赖见 THIRDPARTY.md

收尾

到这里，你已经完成了从构建/获取模拟器、安装固件、加载游戏到备份存档的完整链路，日常使用中主要会用到的是 Settings 里 Graphics 和 System 两个选项卡，以及游戏右键菜单里的缓存管理。

下一步建议：先挑一款官方兼容性列表中标记为可玩的游戏完整跑通两次以上，让 PPTC 缓存生效，感受加载提速的实际效果；然后按自己的显卡性能把 Resolution Scale 从原生分辨率逐步调高。需要深入时，从 docs/README.md 入手了解项目结构和贡献指南，仓库里的 CONTRIBUTING.md 则覆盖了代码风格与开发流程。

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