Atmosphere 1.8.0 安装教程：Switch 19.0.0 固件适配，从 RCM 注入到配置落地的完整实操
【免费下载链接】AtmosphereAtmosphère is a work-in-progress customized firmware for the Nintendo Switch.项目地址: https://gitcode.com/GitHub_Trending/at/Atmosphere
先说结论：如果你的机器还在 18.x 系统、也不急着升，可以完全不动这篇。Atmosphère 是 Nintendo Switch 上的定制固件，从 RCM 注入一直替换到系统服务层，1.8.0 的意义就是适配 19.0.0 系统固件。这篇只讲一件事：怎么把 1.8.0 装上去、跑起来，以及想改配置时去哪儿改。全程四步，每步都有"做完该看到什么"的判断标准。
前置判断：开始安装前你需要什么，什么情况可以跳过
跳过条件很直白：当前跑着 1.7.x 且系统固件没超过 18.1.0 的，1.7.1 本身够用，没必要冒险换包。反过来，系统一旦升到 19.0.0，旧版 Atmosphere 大概率直接起不来，轻则 fatal 报错，重则黑屏，这时必须换 1.8.0。
需要备齐四样东西：
- 一台能进 RCM 的 Switch（fusée 引导 payload 依赖 CVE-2018-6242 漏洞，已被官方修补 RCM 的机器无法使用）；
- 一张已格式化的 SD 卡；
- Atmosphere 1.8.0 发布包（内含
atmosphere/目录和 fusee payload 文件）； - 一根 USB-C 线 + 电脑上的 payload 注入工具（TegraRcmGUI 一类即可）。
⚠️ 动手前一条风险提醒：系统固件升级不可逆。如果你的卡带降级路线依赖卡读卡器固件不被偷升，装完先确认nogc保护处于开启状态（下面第 4 节会讲），这是给未来留后路。
1.8.0 相对 1.7.1 改了什么：一张表看清新旧差异
先给判断：这版改动对用户基本"不可见"，体感就是"新系统能用了"。具体对照见 docs/changelog.md：
| 对比项 | 1.7.1 | 1.8.0 |
|---|---|---|
| 支持系统上限 | 18.1.0 | 19.0.0 |
| 引导链模块 | 对齐 18.x 官方行为 | exosphère、mesosphère、loader、pm、ro 全部按 19.0.0 官方行为重对齐 |
| 崩溃报告（creport） | 生成慢 | 文件访问模式优化，生成速度明显提升 |
| 新硬件兼容 | 部分 Hynix/Micron 颗粒的新机器点不亮 | 已修复 |
顺带一提，1.8.0 起模块普遍改用relr重定位，kips/里不少文件体积变小了，这是正常的。
核心流程：4 步把 1.8.0 装上并跑通
第 1 步：把发布包写进 SD 卡
动作：把发布包里的atmosphere/目录拷到 SD 卡根目录，fusee payload 文件也放根目录。这一步不要动任何配置文件，那是第 3 步的事。
如果你坚持要自己编译（可选）：
git clone https://gitcode.com/GitHub_Trending/at/Atmosphere cd Atmosphere make依赖 devkitA64 / devkitARM / hactool 等工具链，细节见 docs/building.md。普通用户直接用发布包即可。
完成判据：SD 卡根目录能看到atmosphere/文件夹和 fusee payload；打开atmosphere/目录，package3文件和kips/文件夹必须在，缺一个都别往下走。
第 2 步：RCM 注入——最容易翻车的一步
⚠️ 硬件操作别急，按顺序来，每一步都确认状态：
- 关机，按住音量下键不放，按一下电源键后松开，再插 USB-C 线到电脑——机器此刻进入 RCM；
- 打开注入工具，选中 SD 卡根目录的 fusee payload，注入；
- 注入成功屏幕会先黑一下，然后出现 Atmosphere 的启动画面。
完成判据：看到启动画面、随后进入系统主页。首次引导要依次走 fusée → exosphère → 系统，比平时慢，黑屏时别断电、别拔卡，耐心等几十秒。
想换启动图的话，准备一张 1280x720 的图，用仓库里的 utilities/insert_splash_screen.py 处理：
python insert_splash_screen.py <你的图片> <SD卡上/atmosphere/package3>第 3 步：配置模板各就各位
配置文件模板都在config_templates/里，默认值本身就是安全的，但建议先拷出来一份再按需改。每个文件的去处不一样，放混了等于没放：
| 文件 | 放哪里 |
|---|---|
stratosphere.ini | /atmosphere/config/ |
override_config.ini | /atmosphere/config/ |
system_settings.ini | /atmosphere/config/ |
exosphere.ini | SD 卡根目录 |
emummc.ini（仅用 emummc 时） | /emuMMC/ |
cp config_templates/stratosphere.ini /atmosphere/config/ cp config_templates/override_config.ini /atmosphere/config/ cp config_templates/system_settings.ini /atmosphere/config/ cp config_templates/exosphere.ini /完成判据：重启一次，override_config.ini里绑定的按键组合生效（模板默认注释示例是!L）。
第 4 步：验收
开机进系统，随便打开一个应用或卡带，能正常玩、按键绑定按预期触发，安装就算闭环了。
按玩法选配置：三类人改不同的地方
总览先看这张表，再对号入座：
| 场景 | 要改什么 | 基本不碰 |
|---|---|---|
| 只玩卡带 / 数字版 | nogc确认默认即可 | exosphere.ini的debugmode |
| Homebrew + 金手指 | override_config.ini按键、cheats 目录、[hbloader]堆 | [atmosphere]段实验项 |
| 一卡多机 / emummc | emummc.ini、蓝牙库外置 | prodinfo 相关选项 |
只玩官方游戏：保nogc，死守debugmode
stratosphere.ini里的nogc控制卡读卡器保护：Atmosphère 默认会自动保护读卡器固件不被系统更新偷升，这是以后想降级的人最需要的东西，保持默认就行。只有你需要读卡时，才加一行nogc = 0强制放开。
exosphere.ini的debugmode=1别动，模板注释写得很直白：关了它 Atmosphere 直接坏。
Homebrew 与金手指：绑按键，文件放对位置
在/atmosphere/config/override_config.ini的[default_config]段放开override_key/cheat_enable_key两行注释，按键名对照表在 docs/features/configurations.md 里有完整列表（A、L、DLEFT等，前缀!表示反转触发）。
金手指文件放/atmosphere/contents/<程序ID>/cheats/<build_id>.txt，文件名必须是该游戏主可执行文件 build ID 的前 8 字节十六进制，对不上就不加载，加载规则详见 docs/features/cheats.md。个别 Homebrew 内存吃紧的，去system_settings.ini的[hbloader]段调applet_heap_size，默认 0 表示用满 applet 内存，一般不用管。
一卡多机或 emummc：蓝牙配对库外置到 SD 卡
在system_settings.ini的[atmosphere]段放开enable_external_bluetooth_db = u8!0x1，配对库会同步到/atmosphere/bluetooth_devices.db，换机器或换 emummc 环境不用再配一遍手柄。emummc 本身的配置在/emuMMC/emummc.ini，机制文档可参考仓库 emummc/ 目录。
故障诊断：先定位卡在哪一段，再查配置
排错总则记一条就行：先判断卡在哪一阶段（引导 or 系统内），再查对应配置，最后才翻报告。乱删乱拷只会把问题搅浑。
症状：注入后画面停在启动画面不走
最可能：fusee payload 与atmosphere/版本不配套，或 SD 卡内容残缺。处理：先原样重新注入一次；不行就回到第 1 步的判据，重点核对atmosphere/package3和atmosphere/kips/是否齐全、是否混用了新旧两个版本的目录。
症状：进系统后卡带读不出来
最可能：nogc被设成了 1。处理：检查/atmosphere/config/stratosphere.ini，需要读卡就写nogc = 0或删掉该行恢复默认，重启再试。
症状：Homebrew 或 NRO 拒绝启动
先查system_settings.ini的[ro]段ease_nro_restriction（模板默认 1），确认自己没把它关成 0；没问题的话，基本就是 NRO 文件本身与当前版本不匹配，换正确文件。
症状：想搞清楚到底为什么崩
崩溃报告会写到/atmosphere/erpt_reports/，1.8.0 之后生成速度很快，出问题先来这里翻最新一份。要更细的信息，打开system_settings.ini的[lm]段enable_sd_card_logging = u8!0x1，运行日志会落到atmosphere/binlogs。
维护节奏与文档入口
- 更新节奏：官方出新系统固件时不用马上跟，等 Atmosphere 的 release 明确写了支持对应版本，再一次性换包，中间版本可以跳。
- 备份建议：每次换包前把整个
/atmosphere/config/拷走；更稳的做法是把这个目录放进本地 Git 仓库，每次改动提交一次，回滚时不慌。 - 文档入口：常见问题 docs/faq.md、更新日志 docs/changelog.md、编译指南 docs/building.md、配置全解 docs/features/configurations.md、配置模板 config_templates/。
1.8.0 适配到这里就齐了：四步装完，配置按场景挑着改，出事先翻erpt_reports。配置模板里的注释本身就是最好的文档，哪个参数不懂就打开读一遍，真踩了坑再带着报告去社区问，大概率你卡住的点别人也踩过。
【免费下载链接】AtmosphereAtmosphère is a work-in-progress customized firmware for the Nintendo Switch.项目地址: https://gitcode.com/GitHub_Trending/at/Atmosphere
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
