树莓派复古街机DIY全攻略：从硬件选型到RetroPie配置实战

1. 项目概述与核心价值

如果你和我一样，对童年时街机厅里那些像素风游戏念念不忘，同时又对动手制作电子设备充满热情，那么这个基于树莓派（Raspberry Pi）的复古街机DIY项目，绝对值得你投入一个周末的时间。这不仅仅是一个简单的“把游戏机装进盒子”的过程，它是一次融合了硬件选型、嵌入式系统配置、软件模拟器调优以及木工/结构设计的综合性创客实践。最终，你将得到一台独一无二、可以畅玩从雅达利2600到PlayStation 1时代数千款经典游戏的专属街机。

这个项目的核心在于，我们利用树莓派这一廉价、开源且功能强大的单板计算机作为“大脑”，通过RetroPie这一高度集成的复古游戏模拟器平台作为“灵魂”，再配合上经典的街机摇杆和按键作为“肢体”，最终封装进一个由你亲手打造的外壳中。它的价值远不止于怀旧。对于嵌入式系统初学者，你能深入理解GPIO（通用输入输出接口）扩展、USB HID（人机接口设备）协议以及Linux系统下的驱动配置；对于软件爱好者，你能接触到镜像烧录、系统配置、文件传输和模拟器核心调参；对于动手达人，从切割木板到布线理线，每一步都是实实在在的工程实践。

我前后做过三台不同尺寸和风格的树莓派街机，从迷你桌面版到双人站立式，踩过不少坑，也积累了许多能让过程更顺畅的经验。接下来，我会把这些经验毫无保留地分享出来，带你从零开始，避开我走过的弯路，高效地完成这台属于你的复古游戏神器。

2. 硬件选型、采购与设计思路拆解

硬件是整个项目的基石，选对了零件，后续的组装和调试会事半功倍。很多人一开始容易在琳琅满目的配件中迷失，或者为了省钱选择不合适的型号，导致后期兼容性问题频出。我的建议是：在预算允许的范围内，优先选择口碑好、社区支持度高的成熟产品。

2.1 核心大脑：树莓派型号的选择

树莓派型号众多，从Zero到5，性能差异巨大。对于复古街机项目，我们不需要顶级的性能，但需要足够的算力来流畅运行目标平台的游戏，以及充足的USB接口和稳定的供电。

• Raspberry Pi 3B+ 或 4B (2GB/4GB版) 是最佳选择：Pi 3B+性能足以完美模拟PS1及以下的所有主流机种（包括CPS1/2/3街机、NeoGeo、SFC、MD、GBA等），且价格适中。Pi 4B性能更强，可以尝试部分N64、PSP甚至Dreamcast的游戏，但随之而来的散热需求也更高。对于绝大多数复古游戏爱好者，Pi 3B+是性价比的甜点。
• 为什么不选更老的Pi 1或Zero？：原文中提到使用了Pi 1 Model B，这在当时是可行的，但其单核CPU和256MB内存性能非常有限，运行稍复杂的街机游戏（如《拳皇97》）或PS1游戏时会明显卡顿。Pi Zero虽然小巧，但通常只有一个Micro USB口，需要额外的USB HUB来连接摇杆控制器，增加了复杂性和潜在的不稳定性。因此，除非你极度追求迷你化或预算极其紧张，否则不推荐。
• 必备配件：
  • TF卡：至少16GB，Class 10或UHS-I以上速度。推荐32GB，以便存放更多游戏和封面图。品牌选择闪迪（SanDisk）或三星（Samsung）的A1/U1级别卡，系统响应更快。
  • 电源：务必使用官方或认证的5V/2.5A以上（Pi 4建议3A）电源。供电不足是导致树莓派随机重启、摇杆失灵等诡异问题的首要元凶。
  • 散热方案：Pi 3B+可以只用散热片，Pi 4B强烈建议使用小型风扇散热器。过热会触发CPU降频，导致游戏掉帧。

2.2 操控灵魂：街机摇杆与按键套件

这是决定“街机感觉”的关键。市面上主要有两种接口的套件：USB接口和GPIO接口（直接连接树莓派针脚）。

• USB街机套件（推荐给绝大多数人）：这是最简单稳定的方案。你购买的是一个完整的USB控制器板，摇杆和按键的线直接插在这块板上，板子本身通过USB线连接到树莓派。系统会将其识别为标准游戏手柄，无需额外驱动，兼容性极好。套件通常包含：
  • 2个仿三和（Sanwa）或清水（Seimitsu）风格的摇杆（4向或8向）。
  • 12-16个街机按键（通常包含6个动作键、2个开始/选择键等）。
  • 足够长的连接线（杜邦线）和接线端子。
  • 1-2块USB编码板（一个摇杆对应一块板）。
• GPIO直连方案（适合爱折腾的极客）：这种方式需要将每个按键和摇杆方向直接焊接或用杜邦线连接到树莓派的GPIO针脚上，并通过软件（如RetroPie内置的retrogame或gpio驱动）进行映射。优点是成本极低，且能实现超低延迟。缺点是需要一定的电路知识，接线复杂，容易出错，并且会占用大量GPIO针脚，影响其他扩展。
• 选购要点：
  • 按键手感：分为微动开关（Click）和静音硅胶（Silent）两种。前者有经典的“咔哒”声，后者安静。建议至少主按键选择微动开关，体验原汁原味。
  • 键位布局：参考经典街机，如“街霸”的六键布局。购买前确认套件包含的按键数量是否满足你的设计（例如，是否需要单独的投币键、菜单键）。
  • 线材质量：检查连接线是否牢固，端子是否容易松脱。劣质线材是后期接触不良的根源。

2.3 显示与音频：视觉和听觉的呈现

• 显示器：你可以使用闲置的电脑显示器、笔记本电脑屏幕改装，或者购买一块专用的HDMI接口的液晶驱动板搭配裸屏。尺寸建议在10-24英寸之间，取决于你的机箱大小。
  • 分辨率：复古游戏原生分辨率很低（通常240p），在高清显示器上直接全屏会模糊。RetroPie的模拟器支持着色器（Shader），可以模拟CRT显示器的扫描线效果，极大地提升画面质感。因此，一块支持1080p的显示器能获得最佳的可定制化视觉效果。
  • 供电：如果显示器需要独立供电，规划好机箱内的电源插排位置。
• 音频：最简单的方式是利用显示器的3.5mm音频输出或内置扬声器。如果你追求更好的音质，可以为树莓派配置一个USB声卡或通过HDMI音频分离器输出。树莓派本身的3.5mm音频口输出质量一般，且有底噪。

2.4 机箱结构与材料规划

机箱是项目的“皮肤”，决定了最终成品的外观和耐用度。

• 材料选择：
  • 实木板/多层板：质感好，坚固，但加工需要木工工具（线锯、曲线锯），对新手挑战大。
  • 中密度纤维板：易于切割和打磨，表面平整，适合喷漆或贴膜，是最常见的选择。
  • 亚克力板：现代感强，可以制作透明侧板，但切割易崩边，且容易划伤。
  • 激光切割设计：如果你能使用CAD软件（如Fusion 360, Illustrator）设计图纸，并找到激光切割服务，可以获得精度极高、结构复杂的机箱部件。这是目前创客社区最流行的方式。
• 设计考量：
  • 人体工学：控制面板的倾斜角度（通常15-30度）、高度和摇杆按键布局要适合长时间操作。可以参考经典街机框体的尺寸。
  • 内部空间：留出足够空间放置树莓派、线束、音箱（如果外置）和电源模块。确保通风良好，特别是树莓派散热片或风扇周围。
  • 走线管理：提前规划好USB线、电源线、音频视频线的路径，使用扎带或理线槽固定，避免内部杂乱无章，也便于日后维护。
  • 可维护性：考虑设计可开启的背板或侧板，方便更换TF卡、升级硬件或检修。

实操心得：我的第一台街机用了12mm的MDF板，手工切割，虽然歪歪扭扭但成就感十足。第二次我使用了5mm的亚克力板激光切割，精度完美，但机身强度不足，按压时有形变。第三次综合方案：主体结构用15mm MDF保证强度，控制面板和装饰部分用激光切割的亚克力，效果和实用性最佳。建议新手从MDF板开始，成本低，容错率高。

3. 软件系统搭建与核心配置详解

硬件准备就绪后，软件就是赋予其生命的步骤。RetroPie将复杂的模拟器配置、前端界面和手柄映射集成在一起，让我们可以专注于游戏本身。

3.1 RetroPie系统镜像的获取与烧录

这是第一步，也是最关键的一步，一个正确的开始能避免无数后续问题。

1. 下载镜像：访问RetroPie官方网站的下载页面。务必根据你手中的树莓派型号选择对应的镜像。例如，为Pi 4选择“Raspberry Pi 4/400”的镜像。下载完成后，你会得到一个.img.gz的压缩文件。
2. 准备烧录工具：在电脑上使用SD卡烧录软件。强烈推荐使用 Raspberry Pi Imager。它是树莓派官方推出的工具，操作极其简单，会自动验证下载的镜像，并能预先配置Wi-Fi、SSH、地区设置等，大大简化了初次启动的流程。
3. 烧录过程：
   • 将TF卡插入电脑读卡器。
   • 打开Raspberry Pi Imager，点击“选择操作系统”，滚动到最下方，选择“使用自定义镜像”，然后找到你下载的.img.gz文件。
   • 点击“选择存储卡”，选中你的TF卡。
   • （关键步骤）在烧录前，点击右下角的齿轮图标（高级选项）。在这里，你可以预先设置：
     • 主机名（如retropie）
     • 启用SSH（使用密码认证）
     • 设置用户名和密码（默认用户pi，密码raspberry，强烈建议修改）
     • 配置Wi-Fi的国家和密码
     • 设置时区
   • 配置完成后，点击“保存”，然后点击“烧录”。软件会先解压镜像，然后写入，最后自动校验。整个过程需要10-20分钟。

注意事项：烧录会完全清除TF卡上的所有数据，请提前备份。使用Raspberry Pi Imager的“擦除”功能可以彻底格式化旧卡，避免残留分区导致启动失败。

3.2 首次启动与基础系统设置

烧录完成后，将TF卡插入树莓派，连接HDMI线、USB键鼠（临时用于设置）和电源，首次启动。

1. 文件系统扩展：首次启动后，RetroPie会自动进行文件系统扩展，将TF卡的所有空间都利用起来。这个过程会重启几次，请耐心等待，直到进入RetroPie的ES（EmulationStation）前端界面。
2. 手柄配置：此时，插入你的USB街机控制器。系统会检测到新设备，并引导你进行按键映射。按照屏幕提示，依次按下控制器上的上、下、左、右、A、B、X、Y、L、R、选择（Select）、开始（Start）等按键。这里有个重要技巧：对于街机摇杆，将摇杆推向某个方向并保持，然后按下任意键（如A键）来确认该方向。映射完成后，系统会问你是否将此配置作为默认配置，选择“是”。以后所有模拟器都会沿用这个映射。
3. 连接网络：如果你在烧录时未预配置Wi-Fi，可以在ES主界面按“Start”键，进入主菜单，选择“Wi-Fi”进行配置。联网是后续更新、安装额外组件和传输游戏所必需的。

3.3 RetroPie系统深入配置

ES前端只是门面，RetroPie的强大功能藏在配置菜单里。按“Start”键进入主菜单，这里有几个关键设置：

• UI设置：可以更换主题（Theme），RetroPie有大量社区制作的精美主题，让你的游戏库看起来更酷炫。下载主题需要在“RetroPie Setup”里操作。
• 游戏设置：可以设置屏幕保护程序、视频预览等。
• 其他设置：可以关闭系统（切记不要直接拔电源！）。

真正的核心是“RetroPie Setup”。从主菜单退出到命令行（按F4，或在ES的Quit选项中选择“Quit EmulationStation”），然后输入命令sudo ~/RetroPie-Setup/retropie_setup.sh进入图形化设置工具。

在这个工具里，你可以：

• 管理包：安装/卸载不同的模拟器（称为“Emulator”或“Core”）。例如，你想玩DOS游戏，可以在这里安装“DosBox”核心。
• 更新：更新RetroPie-Setup脚本本身和所有已安装的包。定期更新可以获取新功能和修复。
• 配置：进行高级配置，如超频（有一定风险）、音频输出设备选择、蓝牙控制器配对等。
• 实验性包：这里有一些尚不稳定的模拟器或工具，比如用于更高性能平台的模拟器。

4. 游戏资源导入与管理实战

没有游戏的游戏机只是空壳。RetroPie通过一种非常清晰的方式来管理成千上万的游戏。

4.1 理解ROMs目录结构

RetroPie为每个模拟的系统（如nes,snes,arcade,psx）在/home/pi/RetroPie/roms/目录下创建了一个单独的文件夹。这是游戏存放的铁律：FC（红白机）的游戏ROM必须放在nes文件夹里，SFC（超任）的ROM必须放在snes文件夹里，以此类推。

首次启动后，你可以通过多种方式将游戏文件（ROMs）传输到这些文件夹中：

1. USB闪存盘传输（最推荐给新手）：
   • 将一个U盘格式化为FAT32格式。
   • 在U盘根目录创建一个名为retropie的文件夹。
   • 将U盘插入已启动的树莓派，等待约30秒后拔下。
   • 将U盘插回电脑，你会发现U盘里自动生成了以各系统命名的文件夹（如nes,snes）。
   • 将对应的游戏ROM文件复制到这些文件夹里。
   • 再次将U盘插入树莓派，系统会自动将游戏拷贝到TF卡的对应目录。完成后，在ES界面按“F4”刷新游戏列表即可看到新游戏。
2. 网络传输（SFTP，适合熟练用户）：
   • 确保树莓派已联网，并记下其IP地址（在ES的“Show IP”选项中查看）。
   • 在电脑上使用SFTP客户端（如FileZilla）。
   • 连接地址为树莓派的IP，端口22，用户名pi，密码是你设置的密码。
   • 连接到/home/pi/RetroPie/roms/目录，然后直接将ROM文件拖拽到对应的系统文件夹中。传输完成后，在ES界面刷新即可。

4.2 街机游戏ROM的特殊性：MAME与FBA

街机游戏（Arcade）是复古游戏的大头，但其ROM管理最为复杂。主要涉及两大模拟器系列：MAME（Multiple Arcade Machine Emulator）和FBA（FinalBurn Alpha）。它们对ROM的版本要求极其严格。

• 核心概念：每个街机游戏ROM都是一个压缩包（通常是.zip格式），里面包含了该游戏主板的程序代码（ROMs）和图形声音数据。模拟器需要特定版本的ROM集（ROM Set）才能正确识别和运行。
• 如何操作：
  • 你需要在网络上寻找与你的RetroPie版本中MAME或FBA模拟器核心版本号匹配的ROM集。例如，RetroPie默认的lr-mame2003核心，就需要MAME 0.78版本的ROM集。
  • 找到正确的ROM集后，将整个.zip文件（不要解压！）放入/home/pi/RetroPie/roms/arcade/目录下。
  • 在ES的街机游戏列表里，一个游戏可能对应多个模拟器核心。你可以按“A”键启动游戏，或者在游戏条目上按“X”键，手动为其选择最合适的模拟器核心。通常，较老的游戏用lr-mame2003，较新的CPS3、NeoGeo游戏用lr-fbalpha或lr-fbneo兼容性更好。
• 简化方案：对于不想深究版本的新手，可以优先收集“FBA 0.2.97.44 ROM Set”或“MAME 0.78 ROM Set”，这两个版本在RetroPie社区支持度最广，兼容游戏最多。也可以直接寻找为RetroPie打包好的“Arcade Best Of”合集。

4.3 游戏元数据与美化：缩略图与视频预览

当游戏列表只有枯燥的文件名时，体验是不完整的。RetroPie支持为游戏自动下载缩略图（boxart）、标题截图和视频预览。

• 如何获取：在ES的游戏列表界面，按“Start”进入主菜单，选择“Scraper”。配置Scraper的来源（如ScreenScraper.fr，需要注册免费账户），然后选择“Scrape Now”。你可以选择为所有游戏或选中的游戏抓取元数据。
• 网络问题：由于资源服务器多在海外，国内直接抓取可能很慢或失败。解决方案有：
  1. 使用代理（需在树莓派系统层面配置，较为复杂）。
  2. 手动添加：从PC上的前端管理工具（如EmulationStation的PC版）抓取好图片和视频，然后通过SFTP上传到树莓派上对应的/home/pi/.emulationstation/downloaded_images/[系统名]/目录下。
  3. 使用第三方脚本或工具包。

当游戏库配上精美的封面和预览视频后，浏览和选择游戏本身就成了一种享受。

5. 硬件组装、接线与集成全流程

当软件和游戏都准备好后，就可以开始最激动人心的硬件总装了。这个过程需要耐心和细致。

5.1 控制面板的制作与安装

这是与人交互最密切的部分，务必做到牢固、准确。

1. 面板设计与开孔：
   • 在板材上画出所有按键和摇杆的安装位置。标准的街机按键直径是28mm或30mm，开孔器尺寸通常为28mm或30mm。摇杆的开孔是一个方形或圆形的底座孔，以及四个用于固定螺丝的小孔。务必使用开孔器在台钻或手电钻上垂直开孔，否则孔边缘会毛糙，按键卡不紧。
   • 我的经验是，先打印一张1:1的布局图，贴在木板上，用中心冲在每個開孔圓心敲出定位點，再進行鑽孔。
2. 安装微动开关与接线：
   • 将街机按键从面板正面放入孔中，从背面用配套的卡扣或螺母固定。
   • 接线：每个按键有两根线（公共端和信号端）。你的USB编码板上，通常会有一排排的接线端子，标有“GND”（地线）和“BTN1”、“BTN2”等（信号线）。将所有按键的其中一根线（通常是黑色或白色）并联连接到编码板的任何一个“GND”端子。将每个按键的另一根线，按照你设计的布局（例如，第1个攻击键接“BTN1”，第2个接“BTN2”），依次连接到编码板的信号端子上。
   • 摇杆接线：摇杆本质上是四个微动开关（上、下、左、右）。将其“上”方向的线接到编码板的“UP”端子，“下”接“DOWN”，以此类推。同样，将四个方向的公共端并联接到“GND”。
   • 使用接线端子和杜邦线：购买套件时通常会附带一种叫“快接端子”的东西，它可以把按键的金属片和杜邦线母头牢牢压接在一起，比焊接更快捷且便于更换。确保每根线都插接到位，没有虚接。

5.2 内部设备布局与固定

一个整洁的内部空间是稳定运行的保障。

1. 树莓派固定：使用塑料立柱或螺丝将树莓派固定在机箱底板上，避免其晃动短路。
2. 显示器固定：如果使用裸屏+驱动板，需将屏幕稳妥地固定在面板内侧，驱动板用绝缘胶带或扎带固定好。
3. 电源管理：建议使用一个多口USB充电器（如5V/4A）作为总电源，同时给树莓派和显示器供电（如果显示器是5V输入）。将所有220V交流电部分（电源线、插头）用绝缘胶布包裹好，并与低压直流部分（树莓派、控制器）隔离开，确保安全。
4. 线束整理：使用尼龙扎带或理线槽，将电源线、HDMI线、USB线等分别捆扎整齐，避免杂乱无章。过长的线可以盘绕起来固定。这不仅美观，更能防止线材被风扇卷入或松脱。

5.3 最终连接与上电测试

在封闭机箱前，进行最后一次裸板测试。

1. 连接树莓派与显示器的HDMI线。
2. 将USB编码板通过USB线连接到树莓派的USB口。
3. 连接树莓派电源和显示器电源。
4. 开机，进入RetroPie系统。
5. 测试每一个按键和摇杆方向：进入RetroPie的“Input Configuration”（可以在ES设置或retroarch配置中进入），逐一测试每个按键是否都能正确触发，摇杆每个方向是否灵敏。如果发现某个按键无响应，首先检查接线是否牢固，其次检查编码板上的对应端子。
6. 压力测试：运行几个不同类型的游戏（如街机、SFC、PS1），持续玩10-20分钟，观察是否有死机、画面撕裂、声音爆音或按键失灵的情况。同时用手触摸树莓派芯片和电源模块，检查是否过热。

如果一切正常，恭喜你，硬件部分大功告成！可以小心地合上机箱背板，上好螺丝。

6. 高级调优、问题排查与心得分享

即使一切组装完毕，为了让体验达到完美，还有一些高级设置和常见问题需要处理。

6.1 性能与画质调优：RetroArch核心设置

RetroArch是RetroPie背后大多数模拟器（核心）的前端。按“Select + X”键（默认）可以在游戏中呼出RetroArch菜单，这里藏着强大的调校功能。

• 视频设置：
  • 着色器（Shaders）：这是提升复古游戏画面观感的神器。在Settings -> Video -> Shader中加载。推荐crt-pi或crt-pi-curvature着色器，它们能模拟CRT显示器的扫描线和曲面效果，让像素游戏看起来无比柔和、有质感。注意，部分着色器对Pi 3B+性能有压力，如果游戏卡顿，可尝试更轻量的扫描线着色器。
  • 整数倍缩放（Integer Scale）：在Settings -> Video -> Scaling中开启。确保游戏画面以像素整数倍放大，避免模糊。
  • 平滑处理（Bilinear Filtering）：通常建议关闭，以保持像素的锐利感。
• 音频设置：如果遇到音频延迟（音画不同步）或爆音，可以尝试在Settings -> Audio中调整“输出率”（Output Rate）为44100Hz或48000Hz，并开启“音频同步”（Audio Sync）。
• 保存与加载状态：在游戏中，RetroArch菜单的Quick Menu里可以随时保存状态（Save State）和加载状态（Load State），这是攻克高难度游戏的利器。

6.2 常见问题与解决方案速查表

以下是我在多次制作中遇到的一些典型问题及解决方法：

6.3 项目扩展与个性化思路

当基础功能实现后，你可以考虑以下升级，让你的街机更具个性：

• 灯光系统：购买带LED的透明街机按键，并将其连接到USB编码板的电源上（通常有+5V和GND预留口），实现按键背光。你甚至可以通过树莓派的GPIO控制灯光模式。
• 投币器：接入一个真正的街机投币器，通过GPIO或USB接口连接，实现投币游戏的真实体验。
• 音频升级：内置一对优质的全频段喇叭和一个小型功放板，由树莓派的音频口或USB声卡驱动，获得更震撼的音效。
• 前端定制：深入研究EmulationStation的主题文件，修改字体、颜色、布局，甚至自己制作动态主题。
• 流媒体与录屏：利用树莓派的性能，安装OBS或利用RetroArch的录屏功能，录制你的游戏精彩时刻。

回顾整个制作过程，从一堆散乱的零件到一台能发出经典游戏音效的完整设备，最大的成就感来自于这种“从无到有”的创造。我个人的体会是，耐心比技术更重要。接线时慢一点，测试时细一点，遇到问题多查查社区论坛（如RetroPie官方论坛、Reddit的相关板块），几乎所有坑都有前人踩过并提供了解决方案。最后，别忘了在完成后，邀请朋友来家里对战一局《街霸》或《合金弹头》，那份共同的欢乐，才是这个项目最珍贵的价值。