从零开始配置EmulationStation游戏列表：新手避坑完全指南

2026-03-30 11:12:30作者：咎竹峻Karen

EmulationStation作为一款灵活的模拟器前端，支持无键盘导航和自定义系统主题，其游戏列表配置是打造个性化游戏库的核心环节。对于新手用户而言，正确配置游戏列表不仅能让游戏库美观有序，还能大幅提升操作体验。本文将通过"问题-方案-扩展"的实战框架，帮助你快速掌握gamelist.xml的配置技巧，避开常见陷阱。

3分钟定位配置文件

找不到配置文件是新手最常见的困扰。EmulationStation的游戏列表文件（gamelist.xml）采用多位置查找机制，按以下步骤操作即可快速定位：

第一步：检查系统ROM目录

首先查看你的游戏ROM所在文件夹（通常在/home/你的用户名/ROMs/对应系统名称/目录），如果该目录下存在gamelist.xml文件，这就是系统优先使用的配置文件。

第二步：查找用户配置目录

如果ROM目录中没有找到，打开文件管理器进入~/.emulationstation/gamelists/目录，这里按系统名称分类存放用户级配置文件，例如PS1的配置文件路径为~/.emulationstation/gamelists/psx/gamelist.xml。

第三步：系统全局配置

若以上两处都不存在，EmulationStation会读取系统级配置/etc/emulationstation/gamelists/[系统名称]/gamelist.xml，这种情况多见于预装系统。

⚠️ 注意：EmulationStation只会使用找到的第一个有效配置文件，因此建议新手优先修改ROM目录下的gamelist.xml，便于备份和迁移。

元数据必备三要素

游戏元数据就像是游戏的"身份证"，其中有三个核心要素决定了游戏在界面中的显示效果，被称为"元数据黄金三角"：

元数据类型	作用	格式要求	是否必填
name	游戏显示名称	普通文本，建议不超过20个字符	✅ 必须
path	游戏文件路径	支持绝对路径、相对路径（以`./`开头）和用户目录路径（以`~/`开头）	✅ 必须
image	封面/截图路径	支持PNG/JPG格式，建议分辨率为400×560像素	⚠️ 强烈建议

常见错误示范：

<game>
  <name>超级马里奥兄弟</name>
  <!-- 缺少path标签，游戏无法被识别 -->
  <image>mario.jpg</image>
</game>

正确示范：

<game>
  <name>超级马里奥兄弟</name>
  <path>/home/user/ROMs/nes/super_mario.nes</path>
  <image>./covers/super_mario.png</image>
</game>

路径设置的5个陷阱

路径配置是新手最容易出错的环节，以下是需要特别注意的5个陷阱：

陷阱1：混用绝对路径和相对路径

❌ 错误：在同一配置文件中混合使用绝对路径和相对路径，导致部分图片无法加载 ✅ 正确：统一使用相对路径（推荐）或全部使用绝对路径，例如全部使用./covers/游戏名.png格式

陷阱2：忽略路径大小写

❌ 错误：在Linux系统中使用./Covers/Game.png（首字母大写），而实际文件夹名为covers ✅ 正确：严格匹配文件名和路径的大小写，Linux系统区分大小写，Windows系统不区分

陷阱3：使用波浪号(~)在非用户目录

❌ 错误：在系统级配置文件中使用~/downloaded_images/...路径 ✅ 正确：波浪号仅代表当前用户目录，系统级配置应使用绝对路径

陷阱4：路径包含特殊字符

❌ 错误：路径中包含空格或中文，如./game images/塞尔达传说.png ✅ 正确：重命名文件和文件夹，使用下划线代替空格，如./game_images/zelda.png

陷阱5：图片文件格式错误

❌ 错误：指定SVG格式图片（如./icon.svg）或损坏的图片文件 ✅ 正确：使用PNG或JPG格式，确保图片文件可正常打开

元数据卡片：打造视觉化游戏信息

将游戏元数据想象成一张"信息卡片"，除了必备的三要素外，这些可选元数据能让你的游戏库更加丰富：

发行信息组

releasedate：发行日期，⚠️ 格式必须为YYYYMMDDTHHMMSS，例如19950311T000000代表1995年3月11日
developer：开发商，如"Nintendo"
publisher：发行商，如"Square Enix"

游戏特性组

genre：游戏类型，可多个类型用逗号分隔，如"动作,冒险,角色扮演"
players：支持玩家数量，整数，如"2"代表双人游戏
rating：游戏评分，0-1之间的浮点数，如"0.85"代表85分

游玩统计组

playcount：游玩次数，系统会自动更新
lastplayed：最后游玩时间，系统会自动更新为YYYYMMDDTHHMMSS格式

新手提问箱

Q1：为什么我编辑了gamelist.xml但游戏列表没有变化？

A1：有三种可能原因：1)配置文件路径错误，EmulationStation读取的不是你编辑的文件；2)XML格式错误，可使用在线XML验证工具检查；3)游戏文件路径错误，导致EmulationStation无法匹配游戏。建议先通过--ignore-gamelist参数禁用配置文件，确认游戏能正常显示后再重新配置。