首页 / 安装教程

QUICK START · 安装教程

GBA 模拟器使用教程·从 0 到启动

5 步搞定 mGBA 安装、中文设置、ROM 加载、手柄配置、画质优化与金手指启用。新手 3 分钟跟着做就能跑起来。

~/mgba-setup.sh — quick start

[01] $ install mgba

▸ 在 下载中心 选择对应版本（Windows / macOS / Linux），双击安装即可。

[02] $ setlanguage simplified-chinese

▸ 打开 mGBA → 顶部菜单 Tools → Settings → Interface → Language
▸ 选择 简体中文 → OK → 重启程序。整个 UI 立刻变中文。

[03] $ load game.gba

▸ 准备 GBA 游戏 ROM（.gba 文件），从你拥有的 GBA 卡带导出，或合法授权渠道获取。
▸ 文件 → 加载 ROM → 选择 .gba 文件，自动识别后即开始运行。

[04] $ map controller

▸ 工具 → 设置 → 控制 → 按键映射 → 自动检测手柄。
▸ 支持 Xbox / PS4/5 / 北通 / Switch Pro 等绝大多数手柄，键鼠+触屏皆可。

[05] $ enhance --renderer=opengl --filter=xbr

▸ 设置 → 显示 → 渲染后端 = OpenGL
▸ 显示 → 滤镜 = xBR / HQ4x
▸ 老游戏立刻 4K 化，FPS 锁 60。

mGBA 最流畅设置

低配机推荐配置：渲染后端 OpenGL、滤镜关闭、跳帧 0、帧率限制 60。i3 + 集显或骁龙 660 即可流畅运行。

中端机推荐：OpenGL 渲染 + xBR 4x 滤镜 + 整数缩放开启 + 60 FPS 锁定。画面清晰度大幅提升而帧率稳定。

高端机增强：OpenGL 后端 + HQ4x 或 xBR 6x、各向异性过滤、整数缩放、垂直同步开启。GBA 老画面跑出 1080p / 2K 细节。

金手指（GameShark / CodeBreaker / Action Replay）怎么用

启动游戏后，点击 工具 → 金手指（Cheats）
选择 添加新的代码组（Add Cheat Set）
类型选 GameShark v1/v2、CodeBreaker 或 Action Replay v3，粘贴代码
勾选启用，关闭对话框，立即生效
常用代码可在网上搜"游戏名 + GameShark 代码"获取

手柄配置（Xbox / PS / 北通 / Switch Pro）

mGBA 对绝大多数手柄即插即用：连接电脑 → 打开 mGBA → 工具 → 设置 → 控制 → 按键映射 → 自动检测。也可逐键手动映射。

常见问题排查

查看完整 FAQ，覆盖闪退、卡顿、ROM 加载失败、连机、跨设备同步等 12 个高频问题。