以下是对您提供的博文内容进行深度润色与结构重构后的专业级技术指南，严格遵循您的全部要求：
- ✅ 彻底去除AI痕迹，语言自然、老练、有工程师口吻
- ✅ 摒弃“引言/概述/总结”等模板化章节，全文以逻辑流驱动，层层递进
- ✅ 所有技术点均融合进叙述主线，不堆砌术语，重在“为什么这样设计”“踩过哪些坑”“怎么验证才靠谱”
- ✅ 保留全部关键代码、表格、参数与实操细节，并增强可读性与上下文解释
- ✅ 结尾不设“展望”，而是在最后一个实质性技术要点后自然收束，留有思考余味
- ✅ 全文Markdown格式，标题层级清晰、生动贴切，无空洞修饰
Batocera ROM兼容性不是玄学：一个嵌入式工程师的避坑手记
你有没有遇到过这样的场景？
把精心打包的「全平台整合包」拷进U盘，插到树莓派上，开机——EmulationStation（ES）界面清爽漂亮，但点开/roms/snes/，空空如也；再看日志，只有轻描淡写一句：
[INFO] Skipping file: super_mario_world.smc — no matching system你反复确认文件名没错、扩展名对得上、目录也建对了……最后发现，问题出在/roms/下那个叫SuperNintendo/的文件夹——它本该叫snes/。
这不是偶然。这是 Batocera 在用最冷静的方式告诉你：它不接受“差不多”，只认“完全匹配”。
而这种“严苛”，恰恰是它能在树莓派4B、Odroid-N2+、甚至x86迷你主机上稳定运行5年以上的底层逻辑。
我从2019年开始为社区维护 Batocera 核心配置，参与过 v32→v35 的ABI迁移攻坚，亲手调试过上千个整合包的挂载失败案例。今天这篇，不讲概念，不列文档，只说你真正需要知道的三件事：
- ROM是怎么被“看见”的？
- 为什么你的整合包在别人机器上能跑，在你这儿就“隐身”？
- 当报错信息像谜语时，如何三步定位到根因？
ROM不是扔进去就行：ES的识别链路比你想的更“较真”
Batocera 的前端 EmulationStation 看似只是个游戏封面浏览器，但它背后是一套带强契约约束的自动发现系统。它不会主动猜测你是想玩 SNES 还是 Genesis，也不会宽容地帮你把SuperNintendo映射成snes——它只做一件事：查表、比对、拒绝或放行。
这个过程可以拆成四步，每一步都可能成为断点：
第一步：扫描路径，但只扫“合法目录”
ES 启动后，会硬编码扫描/userdata/roms/下的一级子目录。注意，是“一级”，且目录名必须和/usr/share/emulationstation/es_systems.cfg中<name>字段逐字符一致（包括大小写、下划线、连字符）。
比如，这份标准配置里有这么一段：
<system> <name>snes</name> <fullname>Super Nintendo Entertainment System</fullname> <path>/userdata/roms/snes</path> <extension>.smc .sfc .fig .zip</extension> <command>/usr/bin/retroarch -L "/usr/lib/libretro/pocketsnes_libretro.so" --config /userdata/system/configs/retroarch/retroarch.cfg %ROM%</command> </system>
