企业官网建设流程全解析

1. 为什么我选择用树莓派做一台复古街机

第一次在朋友的工作室看到他那台自制的复古街机时，我盯着那块4:3比例的屏幕愣了好几秒。摇杆的段落感、按键的清脆回弹、机身侧面贴着的仿木纹贴纸，甚至连投币口那声“叮”的模拟音效都做了出来。他跟我说，整机成本不到八百块，核心就是一块树莓派4B。那天晚上回家我就下单了同款板子，前后折腾了大概三周，中间踩了不少坑，也推翻过两版方案，最终成品放在客厅角落，周末朋友来家里几乎没人能空着手离开。

这篇文章就是把我从零到一复现这台复古街机的完整过程拆开来讲。核心关键词就三个：树莓派、复古街机、开源。适合谁看？如果你手里正好有一块吃灰的树莓派4B或者3B+，想找个既有成就感又能实际玩起来的项目；或者你是嵌入式方向的学生，需要一个能写进简历、能拿得出手的毕设级作品；再或者你只是单纯怀念小时候游戏厅里那种氛围，想在家里复刻一台属于自己的机器，那这篇内容应该能帮你省下不少查资料和试错的时间。

需要提前说明的是，整套方案的核心软件栈全部基于开源项目，系统镜像、模拟器前端、ROM管理工具都有成熟的社区维护版本。硬件部分除了树莓派主板之外，摇杆、按键、编码器、屏幕、功放板这些配件在常见电商平台都能买到，不需要定制PCB，也不需要焊接复杂电路——当然如果你想做得更精致，后面我也会讲进阶的改造思路。

我最终交付的这台机器，外壳用的是密度板激光切割后手工打磨上漆，屏幕是一块4寸的HDMI接口IPS屏，摇杆和按键走的是USB编码器方案，音频通过3.5mm接口接到一块小功放板再推两个4欧3瓦的全频喇叭。系统层面跑的是RetroPie，前端主题换成了仿街机框体的样式，开机直接进游戏列表，手柄映射在首次配置时一次性写好，之后插电即玩。

下面我会按照“整体设计思路—核心细节解析—实操过程—常见问题排查”这个顺序来展开，每个环节都会把当时做决策的理由和实际踩到的坑讲清楚。如果你只想看具体步骤，可以直接跳到第3节，但我建议至少把第2节关于供电和散热的注意事项看完，这两个地方是我返工次数最多的部分。

2. 整机方案设计与核心思路拆解

2.1 为什么是树莓派而不是其他方案

市面上做复古街机的方案大致分三类：一是买现成的迷你街机成品，二是用旧电脑主机改装，三是用树莓派或者类似的小型单板计算机自建。第一种最省事但可玩性低，系统封闭，想加游戏或者换主题基本没戏；第二种性能过剩、功耗高、体积大，塞进街机框体里散热和走线都很麻烦；第三种是我认为平衡点最好的选择。

树莓派4B的性能对于模拟到PS1世代的2D游戏和大部分街机游戏来说完全够用。我实测下来，CPS1、CPS2、NEOGEO、MAME这些主流街机基板跑起来基本满帧，PS1的2D游戏也没问题，3D游戏个别场景会掉帧但整体可玩。树莓派5当然更强，但价格和功耗也上去了，对于一台复古街机来说，4B的性价比明显更高。如果你手里是3B+，大部分2D街机游戏也能跑，只是PS1和部分MAME游戏会吃力一些。

另一个关键因素是社区支持。RetroPie、Recalbox、Batocera这些开源前端在树莓派上的适配已经非常成熟，镜像烧录完基本就能用，不需要自己编译内核或者折腾驱动。遇到问题在社区里搜一下，大概率已经有人踩过同样的坑。

2.2 硬件选型背后的取舍逻辑

硬件部分我列了一个对比表，把当时考虑过的几个方案和最终选择的原因写清楚：

这里重点说几个决策点。屏幕我一开始想用7寸官方屏，但那个屏是DSI接口，虽然驱动简单，但尺寸太大，塞进我设计的框体里比例不协调，而且价格偏高。后来换成4寸HDMI IPS屏，分辨率800x480，对于街机游戏来说这个分辨率其实刚好——大部分街机原生分辨率是320x240或者384x224，4:3比例拉伸到800x480之后画面不会太糊，像素感反而更有味道。

摇杆和按键我选国产仿三和，原因很直接：一套原装三和摇杆加八个按键的价格够我买三套国产的。实际手感上，国产仿三和的微动开关触发力度比原装稍轻，摇杆的段落感也略弱，但对于非职业玩家来说差异不大。如果你对操作精度有执念，比如经常玩格斗游戏需要精确输入，那建议至少摇杆上原装三和，按键可以继续用国产。

编码器用USB方案而不是GPIO直连，主要是为了省事。GPIO直连需要自己写映射脚本，而且不同模拟器对GPIO输入的支持程度不一样，调试起来很麻烦。USB编码器插上之后系统直接识别成一个标准游戏手柄，RetroPie的配置界面里直接就能映射，双人同玩也只需要两个编码器。代价是多了两根USB线，走线稍微麻烦一点，但完全在可接受范围内。

2.3 软件栈的整体架构

软件层面我用的方案是RetroPie + EmulationStation前端 + RetroArch模拟器核心。这个组合的好处是生态成熟、配置文档齐全、主题丰富。RetroPie本质上是一个预配置好的树莓派系统镜像，烧录完之后通过菜单就能安装各种模拟器核心，不需要自己编译。

EmulationStation是前端界面，负责展示游戏列表、刮削封面和简介、处理手柄输入。RetroArch是模拟器后端，实际运行游戏的核心。两者之间通过配置文件关联，RetroPie已经帮你把大部分配置写好了，你只需要在首次启动时完成手柄映射和ROM目录设置。

这里有一个容易混淆的点：RetroPie、Recalbox、Batocera这三个系统经常被拿来比较。我的使用体验是，RetroPie最灵活，适合愿意折腾的人；Recalbox最省心，开箱即用但自定义空间小；Batocera介于两者之间，界面更现代但对树莓派的优化不如前两者。如果你只是想快速玩起来，Recalbox可能更合适；如果你想深度定制主题、开机画面、游戏列表样式，RetroPie的可玩性更高。

2.4 框体设计的几个关键尺寸

框体我画了三版图纸才定稿。第一版太窄，摇杆和按键挤在一起，玩格斗游戏时手会碰到旁边的按键；第二版太宽，屏幕显得很小，整体比例不协调；第三版调整了面板倾角和按键间距，最终尺寸是宽40cm、深25cm、高15cm（控制面板部分），屏幕以15度倾角嵌入。

控制面板的按键布局我参考了经典街机框体的6键布局，上排三个、下排三个，摇杆在左侧，按键在右侧，两个玩家位之间留了8cm的间距。这个间距很关键，太窄的话双人玩的时候肩膀会打架，太宽的话整体尺寸又收不住。8cm是我实测下来比较舒服的距离。

面板倾角15度是另一个关键参数。太平的话手腕悬空，玩久了会酸；太陡的话视线和屏幕角度不匹配，脖子难受。15度是我反复调整后觉得最自然的倾角，你可以根据自己坐姿和桌面高度微调，但建议不要超过20度。

3. 核心细节解析与实操要点

3.1 树莓派系统烧录与初始配置

系统烧录这一步看起来简单，但有几个细节不注意后面会反复返工。我用的镜像是RetroPie官方为树莓派4B提供的版本，下载下来大概1.2GB。烧录工具用Raspberry Pi Imager，这个工具的好处是可以在烧录前直接配置WiFi、SSH、主机名这些参数，省得烧录完还要接键盘显示器去改。

烧录完成后第一次启动，系统会自动扩展文件系统到整张SD卡，然后重启。重启之后进入EmulationStation的初始配置界面，这里会让你配置手柄。如果你已经接好了USB编码器，直接按提示映射按键就行。注意映射的时候要区分“热键”和普通按键，热键我一般设成Select键，用来组合退出游戏、保存状态、切换存档位。

注意：首次配置手柄时，建议把所有按键都映射一遍，包括摇杆的上下左右和按键的ABXY。有些编码器默认的按键顺序和RetroPie的预期不一致，如果不手动映射，进游戏后按键可能是乱的。

系统配置里有一个容易被忽略的选项：视频输出模式。如果你用的是HDMI屏幕，默认输出可能是1080p，但4寸屏的分辨率只有800x480，不调整的话画面会被缩放得很模糊。在/boot/config.txt里把hdmi_group和hdmi_mode改成对应屏幕分辨率的参数，具体数值可以查树莓派官方文档的HDMI模式表。我用的屏幕对应的是hdmi_group=2、hdmi_mode=87，然后配合hdmi_cvt=800 480 60 6 0 0 0这行参数来精确设置。

音频输出也需要手动指定。默认情况下树莓派会优先走HDMI音频，但我的屏幕没有喇叭，声音要从3.5mm接口出来。在raspi-config里把音频输出改成“3.5mm jack”，或者在/boot/config.txt里加一行audio=on并确保dtparam=audio=on没有被注释掉。

3.2 模拟器核心的选择与配置

RetroPie安装模拟器核心的方式很简单，在RetroPie-Setup菜单里选择“Manage packages”然后“Manage experimental packages”，找到对应的模拟器核心安装就行。但装哪些核心、怎么配置，这里面有不少讲究。

街机游戏主要用MAME和FBNeo两个核心。MAME的兼容性最好，支持的游戏最多，但对硬件要求也最高；FBNeo对CPS1、CPS2、NEOGEO这些基板的模拟更精准，性能也更好。我的做法是：CPS1、CPS2、NEOGEO的游戏用FBNeo跑，其他街机游戏用MAME 2003-Plus或者MAME 2010跑。MAME 2003-Plus是基于老版本MAME的优化版，对树莓派的性能更友好，大部分经典街机游戏都能跑满帧。

家用机方面，NES、SNES、Genesis用对应的专用核心就行，这些核心在树莓派4B上跑起来毫无压力。PS1用PCSX-ReARMed核心，大部分2D游戏满帧，3D游戏个别场景掉帧。N64和Dreamcast我不建议在树莓派4B上折腾，体验很差，除非你上树莓派5。

提示：模拟器核心不是越多越好。装太多核心会让RetroPie的菜单变得很长，而且不同核心之间的配置可能会冲突。建议只装你实际会玩的那几个平台的核心。

ROM的命名和目录结构也有讲究。RetroPie默认的ROM目录在/home/pi/RetroPie/roms/下面，每个平台一个子目录。ROM的文件名建议用英文，不要有特殊字符，否则刮削封面的时候容易匹配失败。如果你用的是No-Intro或者Redump的ROM集，文件名本身就是规范化的，直接放进去就行。

3.3 手柄映射与按键布局的细节

USB编码器接上树莓派之后，系统会把它识别成一个标准HID游戏手柄。在EmulationStation里配置一次之后，RetroArch里还需要再配置一次，因为两者是独立的手柄输入系统。这一步很多人会漏掉，结果就是前端界面能用手柄操作，但进游戏之后手柄没反应。

RetroArch的手柄配置在“Settings > Input > Port 1 Binds”里面。把方向键、ABXY、Start、Select、L/R键都映射好之后，记得在“Settings > Input > Hotkeys”里配置热键组合。我常用的几个热键组合是：Select+Start退出游戏、Select+R保存即时存档、Select+L读取即时存档、Select+右切换存档位。这些组合在玩游戏的时候非常实用，尤其是街机游戏不能随时存档，即时存档功能可以让你在关键节点保存进度。

按键布局方面，6键街机布局对应的是RetroArch里的Y、X、L、B、A、R六个键。具体哪个键对应哪个功能，取决于你玩的游戏。比如街霸系列的重拳重脚通常映射到L和R，轻拳轻脚映射到Y和B。这个可以在RetroArch的“Quick Menu > Controls”里针对每个游戏单独调整，调整完之后在“Quick Menu > Overrides”里保存游戏专属配置，下次进这个游戏就会自动加载。

3.4 音频与供电的避坑要点

音频部分我踩的坑最多。一开始我直接用树莓派的3.5mm接口接了一个小喇叭，声音小得几乎听不见，而且底噪很大。后来查资料才知道，树莓派的3.5mm接口输出功率很低，直接推喇叭是不行的，必须经过功放板放大。

我换了一块PAM8403功放板，输入接树莓派的3.5mm接口，输出接两个4欧3瓦的全频喇叭。PAM8403的供电直接从树莓派的5V引脚取电，功放板本身功耗很小，不会对树莓派供电造成明显负担。接上之后音量足够了，底噪也小了很多。如果你对音质有更高要求，可以换PAM8610或者TPA3110功放板，但那些需要独立供电，走线会更复杂。

供电是另一个大坑。树莓派4B的官方推荐电源是5V3A，但如果你同时接了屏幕、编码器、功放板、可能还有USB存储设备，3A的余量就不太够了。我一开始用的是一个5V2.5A的旧电源，结果玩游戏的时候偶尔会闪屏，查日志发现是电压不足导致的。换了一个5V3A的电源之后问题就消失了。

注意：树莓派4B对电压非常敏感，低于4.8V就可能出现各种奇怪的问题，比如USB设备掉线、WiFi断连、系统卡顿。如果你遇到这些症状，第一件事就是换一个质量好、电流余量足的电源。

如果你想把所有东西都塞进框体里，可以考虑用一块5V5A的开关电源，直接从220V转5V，然后分两路：一路给树莓派，一路给屏幕和功放板。这样走线更整洁，也不用担心电流不够。但开关电源的纹波可能会对音频造成干扰，如果出现电流声，可以在电源输出端加一个LC滤波电路。

4. 完整实操过程与核心环节实现

4.1 框体加工与面板开孔

框体我用的是15mm厚度的密度板，激光切割之后手工打磨。如果你没有激光切割机，也可以用木工锯加砂纸慢慢做，只是精度会差一些。图纸我是在网上找了一个开源街机框体的DXF文件，然后根据我自己的屏幕尺寸和按键布局改了尺寸。

控制面板的开孔是最关键的一步。摇杆的开孔直径是24mm，按键的开孔直径是30mm。开孔位置我用的是纸模板定位法：先在纸上按1:1打印出按键布局，贴到面板上，然后用中心冲在孔位打个记号，再用开孔器钻孔。开孔器要用木工专用的那种，转速不要太高，否则密度板容易崩边。

提示：钻孔之前一定要在废料上试钻一次，确认开孔器的直径和转速合适。密度板崩边之后很难修复，只能重新切一块面板。

面板钻完孔之后，用砂纸从120目打磨到400目，把边缘的毛刺磨掉。然后上底漆、打磨、上面漆、再打磨，重复三遍。我最后用的是哑光黑色自喷漆，喷了三层，每层间隔半小时。漆面完全干透之后贴了一层仿碳纤维的贴纸，质感比纯黑好很多。

4.2 摇杆与按键的安装接线

摇杆和按键的安装顺序是先装摇杆再装按键。摇杆从面板下方穿上来，用配套的螺丝固定。注意摇杆的方向：摇杆的微动开关有四个方向，安装的时候要确保摇杆的“上”方向对应面板的正上方。有些摇杆的安装孔是方形的，可以旋转90度安装，如果你习惯用左手摇杆或者右手摇杆，可以在这里调整。

按键从面板上方按下去，卡扣会自动卡住。如果卡扣太松，可以在按键边缘缠一圈电工胶带增加摩擦力。按键的接线很简单，每个按键有两个引脚，一个接编码器的信号线，一个接编码器的地线。USB编码器一般会附带一套杜邦线，按颜色区分信号和地线，照着编码器的说明书接就行。

摇杆的接线稍微复杂一点，因为摇杆有四个方向微动加一个公共地。编码器上一般会有专门的摇杆接口，是一个5针的排针，对应上、下、左、右、地。如果你买的编码器没有专用接口，也可以把摇杆的四个方向线分别接到编码器的按键输入上，然后在RetroArch里把对应的按键映射成方向键。

4.3 屏幕与音频模块的集成

屏幕我用的是4寸HDMI IPS屏，驱动板自带HDMI输入和3.5mm音频输出。屏幕的供电可以从树莓派的USB口取5V，也可以从驱动板上的Micro USB口单独供电。我选择从树莓派的USB口取电，这样只需要一根电源线进框体。

屏幕的安装方式是在面板上开一个和屏幕可视区域等大的方孔，然后把屏幕从后面贴上去，用热熔胶或者螺丝固定。屏幕和面板之间要垫一圈黑色泡棉胶条，防止漏光和进灰。屏幕的驱动板用尼龙柱固定在框体内部，HDMI线和电源线用扎带理好，避免晃动。

音频模块的集成前面已经讲过，PAM8403功放板加两个4欧3瓦喇叭。喇叭我装在框体两侧，开孔直径和喇叭外径一致，用热熔胶固定。功放板的输入接树莓派的3.5mm接口，输出接喇叭，供电从树莓派的5V引脚取。注意功放板的左右声道不要接反，否则声音的方位感会错乱。

4.4 系统调试与游戏导入

所有硬件装好之后，通电开机，进入RetroPie系统。首先检查屏幕分辨率是否正确，如果画面模糊或者有黑边，回到/boot/config.txt调整HDMI参数。然后检查音频输出，在命令行里运行speaker-test -c 2 -t sine，应该能听到左右声道交替的测试音。

手柄映射在EmulationStation和RetroArch里各做一次，前面已经讲过。然后导入ROM：把ROM文件通过U盘或者SFTP传到/home/pi/RetroPie/roms/对应的平台目录下。RetroPie支持U盘自动导入，你只需要在U盘根目录建一个retropie文件夹，里面按平台建子目录，插上U盘之后系统会自动复制ROM并刮削封面。

刮削封面需要联网，RetroPie用的是ScreenScraper或者TheGamesDB的数据库。刮削速度取决于网络质量和ROM数量，我大概有三百多个ROM，刮削花了将近一个小时。刮削完成之后，游戏列表里每个游戏都会显示封面、简介、发行年份、玩家人数这些信息，看起来很有感觉。

注意：刮削的时候如果某个游戏匹配不到封面，可以手动在/opt/retropie/configs/all/emulationstation/gamelists/下面编辑对应的gamelist.xml文件，手动指定封面路径和游戏信息。

4.5 开机画面与主题定制

RetroPie默认的开机画面是树莓派的彩虹logo，我换成了自己做的复古街机风格开机动画。具体做法是在/opt/retropie/supplementary/splashscreen/目录下放一张640x480的PNG图片，然后在RetroPie-Setup里启用splashscreen功能。开机动画的图片可以用Photoshop或者GIMP做，我找了一个开源像素字体，打上“RETRO ARCADE”几个字，加了一点扫描线效果。

EmulationStation的主题我换成了“Carbon”主题的街机变体，这个主题的布局是左侧游戏列表、右侧游戏封面和简介、底部显示操作提示。主题文件放在/etc/emulationstation/themes/下面，在EmulationStation的UI设置里切换。如果你会写XML，也可以自己改主题的布局和配色，可玩性很高。

5. 常见问题与排查技巧实录

5.1 开机黑屏或花屏

这是最常见的问题，原因通常有三个：HDMI参数不对、屏幕供电不足、SD卡系统损坏。排查顺序是先用另一台显示器接树莓派的HDMI口，看能不能正常输出。如果能，说明是屏幕参数问题，回到/boot/config.txt调整hdmi_group、hdmi_mode、hdmi_cvt这几个参数。如果不能，换一张烧录好的SD卡试试，排除系统问题。如果换了卡还是不行，检查电源电压，用万用表量一下树莓派5V引脚的实际电压，低于4.8V就要换电源。

5.2 手柄在游戏里没反应

前端能用但游戏里没反应，说明RetroArch的手柄配置没做。进入RetroArch的“Settings > Input > Port 1 Binds”，重新映射一遍。如果映射之后还是没反应，检查/opt/retropie/configs/all/retroarch/autoconfig/目录下有没有对应编码器的配置文件。有些编码器需要手动添加autoconfig文件，文件内容是一个CFG格式的文本，指定了每个按键对应的RetroArch输入编号。

5.3 游戏运行卡顿或掉帧

树莓派4B的性能瓶颈主要在CPU单核性能和GPU上。如果某个游戏卡顿，先确认用的是哪个模拟器核心。CPS1、CPS2、NEOGEO的游戏用FBNeo核心，其他街机用MAME 2003-Plus。如果换核心之后还是卡，可以在RetroArch的“Quick Menu > Options”里调整一些参数，比如关闭帧缓冲、降低音频采样率、关闭着色器。另外，确保树莓派的CPU频率没有被限制在省电模式，在/boot/config.txt里加一行force_turbo=1可以锁定最高频率，但要注意散热。

5.4 音频有底噪或电流声

底噪的来源通常是电源纹波或者地线环路。先检查功放板的供电是不是和树莓派共用同一个电源，如果是，尝试给功放板单独供电。如果底噪依然存在，在功放板的电源输入端并联一个1000uF的电解电容和一个0.1uF的陶瓷电容，可以滤掉大部分高频纹波。另外，音频线尽量用屏蔽线，走线远离电源线和HDMI线。

5.5 常见问题速查表

5.6 几个我踩过的独家坑

第一个坑是SD卡的选择。我一开始用了一张杂牌的32GB卡，系统跑起来没问题，但玩游戏的时候偶尔会卡顿一下。后来换了一张三星的EVO Plus卡，卡顿就消失了。树莓派对SD卡的随机读写性能比较敏感，建议用Class 10以上的品牌卡，容量32GB起步，如果你ROM多的话直接上64GB或者128GB。

第二个坑是散热。树莓派4B的发热比3B+大不少，不加散热片的话玩半小时左右就会降频。我一开始只贴了三个小散热片，后来发现不够，换了一个带风扇的金属外壳，温度从70多度降到了50度左右。如果你把树莓派塞在封闭的框体里，散热尤其重要，建议至少加一个5V小风扇，从框体底部抽风、顶部排风。

第三个坑是USB编码器的供电。有些便宜的USB编码器在树莓派上会出现随机掉线的问题，尤其是双人同玩的时候。我后来在编码器的USB线上加了一个带供电的USB Hub，问题就解决了。如果你遇到手柄偶尔失灵，可以试试这个办法。

第四个坑是ROM的格式。MAME的ROM版本和模拟器核心的版本必须匹配，否则会出现“ROM缺失”或者“CRC错误”的提示。我建议用MAME 2003-Plus对应的ROM集，这个ROM集在社区里流通最广，兼容性最好。如果你从不同来源下载ROM，注意检查ROM的版本号，不要混用。

6. 后续可以继续折腾的方向

这台机器我目前已经稳定使用了几个月，周末朋友来家里玩的时候反馈都不错。如果你已经完成了基础版本，后面还有几个方向可以继续折腾。

一个是加装投币器和硬币识别模块，让整台机器的仪式感更强。投币器有机械式和电子式两种，机械式的便宜但需要手动复位，电子式的可以配合树莓派的GPIO做计数和音效触发。另一个方向是加装LED灯带，在框体边缘和按键下方做RGB灯效，可以通过GPIO控制颜色和亮度，晚上玩的时候氛围感拉满。

软件层面可以折腾的东西更多。比如给RetroPie加一个游戏统计插件，记录每个游戏的游玩时长和次数；或者做一个本地排行榜系统，双人对战的时候自动记录胜负；再或者把树莓派连上家庭网络，通过手机浏览器远程管理ROM和配置。这些都有开源项目可以参考，社区里搜一下关键词就能找到。

如果你做的是毕设或者想拿这个项目去参加比赛，建议在文档和演示视频上多花点功夫。把硬件选型对比、系统架构图、关键配置参数、实测性能数据都整理清楚，再录一段从开机到玩游戏的完整演示，整个项目的完成度会高很多。我见过不少技术做得不错但展示拉胯的项目，挺可惜的。

最后分享一个我在调试过程中总结的小技巧：每次改完配置文件之后，不要急着重启，先在命令行里用vcgencmd get_config int检查一下参数有没有生效。这个命令会列出当前生效的所有config.txt参数，比翻文件快得多。另外，养成备份SD卡镜像的习惯，系统调好之后用dd命令把整张卡备份成一个img文件，下次换卡或者系统崩了直接恢复，省得从头再配一遍。