Switch 装不上游戏？用 Awoo Installer 把 NSP、XCI 装进主机的完整流程-平芜编程栈

Switch 装不上游戏？用 Awoo Installer 把 NSP、XCI 装进主机的完整流程

【免费下载链接】Awoo-InstallerA No-Bullshit NSP, NSZ, XCI, and XCZ Installer for Nintendo Switch项目地址: https://gitcode.com/gh_mirrors/aw/Awoo-Installer

读完这篇文章，你能自己从源码编译 Awoo Installer、按场景挑一条合适的通道，把 NSP / NSZ / XCI / XCZ 文件可靠地送进 Switch，并把签名校验与签名补丁这两道保险都接上。它解决的正是"文件明明下好了，Switch 却死活装不上"这个最让人上头的问题。

一张速览表：这个安装器能干什么

支持格式：NSP、NSZ、XCI、XCZ，以及分割版 NSP / XCI。
安装通道：SD 卡、USB、局域网 / 互联网，共 3 条可选。
附加能力：安装前校验 NCA 头签名；一键安装 / 更新 / 卸载签名补丁；自动检查 Awoo Installer 更新。
界面：图形化菜单，内置简中、繁中、日、韩、俄等 12 种语言。

三个词先搞懂，后面流程顺很多

NSP / NSZ 是"一次性安装包"，装完就没用了；XCI / XCZ 更像"整张光盘的镜像"；NSZ 与 XCZ 是前两者的压缩版，体积小、传得快。
签名补丁可以理解为"系统认不认你这份内容"的许可章。HOS 一升级，章就可能失效——游戏装上了，但打不开。
安装通道决定文件从哪儿进主机：拔卡走 SD 卡、线连走 USB、无线走网络。

编译部署并装第一个游戏的主线

先备一套 DevKitPro 交叉编译环境，然后：

git clone https://gitcode.com/gh_mirrors/aw/Awoo-Installer cd Awoo-Installer make

编译完成会拿到Awoo-Installer.nro。把它放进 SD 卡的switch/Awoo-Installer/目录（工具运行后写在这里的config.json也会随之生成），插回 Switch 从 hbmenu 启动即可。

⚠️ 如果你是从相册这类 Applet 模式下启动，会弹出 "Applet Mode not supported" 提示，界面可能出现异常。稳妥做法是回主界面按住 R 键打开任意游戏，进 hbmenu 后以完整内存模式启动 Awoo Installer。

进入主菜单后，选Install from SD card，浏览到游戏文件所在目录，A 键选中单个文件，或 + 键全选，再按 + 键开始安装；接着在SD Card / Internal Storage二选一；装完工具会问要不要顺手把 SD 卡上的源文件删掉，空间紧张就删，想留备份就否。

三条安装通道的取舍

三条通道没有绝对优劣，看场景：

SD 卡：把文件拷进卡里就能装，上手成本最低；一次装多个文件、第一次跑流程都合适。
USB：速度最快，适合批量和大文件。用 NS-USBloader 这类工具、切到 Tinfoil 模式把文件推进来即可；部分设备 / 线缆组合下会不通畅，工具首次进入 USB 页时也会给出官方警告。
网络（LAN / 互联网）：免拔卡，网页或第三方工具按 Switch 屏幕显示的 IP 把文件推过去；也可以走 URL 直链，或填 Google Drive 的公开文件 ID 让 Switch 自己下载。网络安装不限制文件扩展名，遇到第三方工具识别不了特定后缀时改一下就行。

第一次用建议从 SD 卡起步；日常补游戏走网络；一次灌几十个文件上 USB。

别省的两道保险：NCA 校验与签名补丁管理

NCA 头签名校验：安装前工具会校验每个 NCA 的头部签名，异常时弹警告让你确认。整合型 XCI 与含 DLC 解锁器的文件会一直触发此提示，属正常现象；来源不明的文件出现警告就该停下来想清楚。真想关掉，进Settings → Verify NCA signatures before installation一关即可，但风险自负。

签名补丁管理：主菜单进Manage signature patches，工具会读sdmc:/atmosphere/exefs_patches/es_patches/patches.txt判断当前版本，给出 Install / Update / Uninstall。更新前会自动备份 Hekate 的patches.ini（用 Hekate 才需关注，不用则忽略），装完提示重启主机生效。系统升级后游戏打不开，第一件事就是来这里看补丁要不要刷新。

遇到装不上，按症状排查

症状：安装中断或 Failed→ 可能原因：空间不足、文件本身不完整、当前通道异常。处理：先查存储空间，再换一条通道（SD 卡 ↔ 网络）重试。
症状：装完游戏打不开→ 可能原因：签名补丁版本落后、Atmosphere 太旧。处理：回Manage signature patches更新补丁，再检查 Atmosphere 版本。
症状：网络安装连不上 / 传输中断→ 可能原因：不同网段、飞行模式、大文件超时。处理：确认同一 Wi-Fi、飞行模式关掉；大文件改走 USB 或 SD 卡。
症状：USB 没反应 / 传输超时→ 可能原因：数据线只支持充电、接口不识别、平台差异。处理：换带数据传输的 USB-C 线、换 USB 口、重启双方；仍不通就转网络或 SD 卡。
症状：从 Applet 模式启动后界面卡→ 处理：退回主界面，按住 R 键打开任意游戏，从 hbmenu 完整内存模式重启工具。

顺手一提，Settings里还有几个按习惯调的开关：Ignore minimum firmware version required by titles（装高于当前固件的游戏时打开，注意兼容性）、boost mode（安装时 CPU 超频，SD 卡够快再开）、Ask to delete original files after installation（不想要装完的删除提示就关）、auto check for Awoo Installer updates（保持开启即可），语言在Settings → Language切换。