Ryujinx是用C#编写的开源Nintendo Switch模拟器，支持Windows、Linux和macOS系统，可免费运行《塞尔达传说：王国之泪》《集合啦！动物森友会》等超4300款Switch游戏，具备高兼容性、高性能及用户友好界面。
想在Mac上用大屏幕玩《塞尔达传说：王国之泪》或《动物森友会》，又不想买Switch主机，就得靠Ryujinx或Yuzu模拟器——但直接双击运行只会弹出“未经验证的开发者”警告，游戏文件拖进去也显示“缺少固件”，系统语言全是日文，连主界面都卡在加载状态。
绕过Mac安全限制并首次启动模拟器
打开“访达”→进入“应用程序”文件夹→右键点击Ryujinx或Yuzu图标→按住Control键不放再单击→选择“打开”→点“仍要打开”。这一步必须手动触发，否则系统会彻底阻止运行。
首次启动时若弹出“无法检查是否含有恶意软件”，说明Gatekeeper拦截生效，此时需临时关闭：打开“终端”，粘贴执行 sudo spctl --master-disable →输入管理员密码（输入时不显示字符，输完直接回车）→重启电脑。该操作仅影响本机安全策略，不影响其他应用。
启动后窗口空白或闪退，大概率是没建portable目录。在模拟器同级目录下新建名为portable的空文件夹，再重启程序——Ryujinx和Yuzu都会自动将配置、缓存、存档写入此目录，避免权限冲突。
准备并安装Switch系统固件
固件不是随便下载一个就能用。必须匹配你手头游戏的发布日期：比如《超级马力欧兄弟：奇异之旅》（2023年10月发售）要求固件≥16.0.0；而《火焰纹章：Engage》（2023年1月）最低需14.1.2。查游戏版本最准的方式是看NSP/XCI文件名里的数字后缀，如Fire_Emblem_Engage_[1.1.0]_[0100F0E012345678].nsp，其中1.1.0对应固件14.1.2。
方法一：从实体Switch提取（合法且最稳妥）
用TegraRcmSmash等工具配合USB线连接主机，在RCM模式下导出boot.dat和nso文件，再用Lockpick_RCM生成完整固件ZIP包。此方式获得的固件自带签名，Ryujinx/Yuzu识别率100%，不会报“Invalid firmware signature”错误。
方法二：使用公开固件包（仅限测试）
下载后缀为.zip的固件包（如Firmware_16.0.2.zip），解压确认内部含system/目录及多个.nca文件。切勿使用仅含prod.keys的“精简版”固件包，Yuzu会提示“Firmware version mismatch”，Ryujinx则直接跳过安装按钮。
安装路径必须严格遵循：Ryujinx→Tools → Install Firmware → Install a firmware from XCI or ZIP；Yuzu→File → Install Firmware。选中ZIP文件后，Ryujinx会自动解压到portable/system/，Yuzu则存入portable/nand/system/Contents/registered/。安装成功后，Ryujinx右下角显示v16.0.2，Yuzu主界面左上角出现固件版本号。
注入密钥文件让游戏真正可运行
没有密钥，固件只是摆设。Ryujinx和Yuzu都需要两个核心文件：prod.keys（主密钥）和title.keys（标题密钥）。它们必须放在portable/system/目录下，且文件名一字不差、全小写、无扩展名错误（例如不能是prod.keys.txt）。
密钥来源必须与固件版本对齐。例如固件16.0.2要求prod.keys内包含master_key_0a至master_key_0f共16组密钥，缺任意一组，加载NSP游戏时就会卡在“Decrypting NSP…”并报错Key not found for title key。网上流传的旧版密钥包（如2022年前打包）大概率缺失16.x新增密钥，导致《马里奥赛车8豪华版》DLC无法载入。
验证密钥是否生效：启动模拟器→打开设置→切换到“System”选项卡→查看“Firmware Version”下方是否显示“Keys loaded: 2/2”。若显示“1/2”或“0/2”，说明title.keys缺失或格式损坏，需重新下载完整密钥包并用文本编辑器确认无BOM头。
添加游戏并设置中文系统语言
第一步：把游戏文件放进独立文件夹
不要把XCI/NSP文件直接丢进桌面或下载目录。新建一个纯英文命名的文件夹（如switch_games），将所有游戏文件放入。中文路径会导致Ryujinx解析失败，Yuzu则在扫描时跳过整个目录。
第二步：绑定游戏库路径
Ryujinx：点击Options → Settings → General → Add→选择switch_games文件夹→点右下角Add→再点Save。
Yuzu：点击File → Load File→选择单个XCI/NSP文件，或点击File → Load Directory→选中switch_games→勾选Scan subdirectories→点OK。
第三步：强制设为中文系统
Ryujinx：进入Options → Settings → System→将System Language下拉菜单改为Chinese (Simplified)→Region选China→Time Zone选Asia/Shanghai→保存后重启模拟器。
Yuzu：进入Emulation → Configure → System→同样设置语言/地区/时区→关键一步：勾选Use custom user data，否则修改无效。
第四步：启用性能关键选项
Ryujinx：在Options → Settings → Graphics中，必须开启Enable Shader Cache和Enable Async GPU Emulation，否则《旷野之息》开场动画会卡顿10秒以上；CPU Clock Rate保持100%，调高反而触发不稳定。
Yuzu：在Graphics → Advanced中，将GPU Accuracy设为Normal（设为High会导致M1/M2芯片GPU占用飙升至95%却帧率不升），Async Shaders必须打开，否则《健身环大冒险》体感动作延迟严重。
解决Mac平台特有崩溃问题
方法一：禁用Hypervisor加速（M1/M2芯片必做）
Ryujinx默认启用Hypervisor提升CPU性能，但在Apple Silicon上会导致《异度神剑3》随机崩溃。进入Options → Settings → System→取消勾选Use Hypervisor→重启模拟器。这会降低约5%帧率，但换来全程稳定。
方法二：强制Metal后端渲染（仅Yuzu）
Yuzu在Mac上默认尝试OpenGL，但M系列芯片已弃用该API。启动Yuzu前，在终端执行：
export SDL_VIDEODRIVER=metal
open -a Yuzu.app
这两行命令确保Yuzu跳过OpenGL检测，直连Metal驱动。不执行则《宝可梦朱/紫》加载地图时必然黑屏。
方法三：调整内存分配策略（所有Mac用户）
在portable/config.json（Ryujinx）或portable/config/qt-config.ini（Yuzu）中，找到memory相关字段，将heap_size设为1073741824（即1GB），避免macOS内存压缩机制误杀模拟器进程。此值不可超过物理内存的1/4，否则系统会强制终止后台应用。
