Cemu .wud / .wux 格式报错 — keys.txt 缺失、密钥错误、区域不匹配分别排查
症状
游戏文件明明放在 Game Paths 里，但 Cemu 列表里没显示，或者双击加载时报错：
- "Decryption failed"
- "Key not found"
- "Error loading game"
- 直接闪退
99% 是密钥问题。
核心原因：WUD/WUX 需要密钥解密
回顾游戏格式章节：
| 格式 | 需要 keys.txt | 理由 |
|---|---|---|
| WUD | ✅ | 光盘原始数据，加密的 |
| WUX | ✅ | WUD 压缩版，还是加密的 |
| WUA | ❌ | 转储时就解密好了 |
| RPX 目录 | ❌ | 解包格式，明文 |
如果你用 WUD/WUX 格式，必须有正确的密钥。
排查步骤
第一步：keys.txt 在 Cemu 根目录吗
确认文件位置：
Cemu/
├── Cemu.exe
└── keys.txt ← 必须在这里，和 Cemu.exe 同级不能在 mlc01/ 里、不能在 resources/ 里、不能在子文件夹里。就是和 Cemu.exe 同级。
第二步：keys.txt 文件名对吗
文件名必须精确叫 keys.txt（全小写）。有没有不小心存成 Keys.txt、key.txt 或 keys.txt.txt（资源管理器隐藏扩展名导致）？
在资源管理器 → 查看 → 显示文件扩展名 → 确认文件名就是 keys.txt。
第三步：keys.txt 内容对吗
用记事本打开 keys.txt：
- 文件大小不应该是 0 字节
- 应该有多行十六进制字符串（每一行一个密钥）
- 如果只有一行甚至空的——密钥不全
密钥应该是你自己从 Wii U 转储的（Dumpling 工具导出的），或者从你自己的 Wii U 上提取的。
第四步：密钥和游戏匹配吗
这是最容易被忽略的问题：WUD/WUX 的密钥是每张光盘唯一的。
- A 光盘的密钥不能解 B 光盘的数据
- 区域版本（EUR/USA/JPN）不同密钥可能也不同
症状：keys.txt 存在但只有部分游戏能识别。
解决：确保 keys.txt 里包含所有你想玩的 WUD/WUX 光盘的密钥。Dumpling 转储时每张光盘都会提取对应的密钥，全部放进同一个 keys.txt 就行。
第五步：直接转 WUA 跳过密钥问题
如果上面四步都做了还是有问题——直接用 WUA 格式得了：
- 回到 Wii U 用 Dumpling 重新转储同一个游戏
- 格式选 WUA（而不是 WUD/WUX）
- WUA 在转储时就解密好了——不需要任何密钥
- Cemu 扫描到 WUA 直接显示在列表里，双击就能开
这是官方推荐的格式。除非你有特殊原因非要用 WUD/WUX，否则 WUA 能让你完全避开 keys.txt 这个坑。
用 keys.txt 的常见坑总结
| 问题 | 原因 |
|---|---|
| 文件位置不对 | 必须在 Cemu 根目录 |
| 文件名大小写 | 必须全小写 keys.txt |
| 文件是空的 | 密钥没提取成功 |
| 密钥不全 | 只提取了部分光盘的密钥 |
| 密钥不匹配 | A 光盘密钥解 B 光盘 |
WUA 是终极解决方案
再强调一次：WUA 格式 = 零密钥烦恼。
- 体积更小（2~8GB vs WUD 的 25GB）
- 不需要 keys.txt
- Cemu 2.x 完美支持
- 社区推荐首选格式
唯一前提：Dumpling 转储时格式选 WUA。