支持的金手指格式
mGBA 支持 GameShark V3、Pro Action Replay（PAR）、Code Breaker 等主流金手指格式。直接将 8 位或 16 位十六进制代码粘贴到金手指面板即可启用。0.10.0 起新增对"never"型代码的支持，进一步扩展兼容范围。
User Guide
使用指南
无论你是初次接触模拟器的新手玩家，还是希望深入使用调试工具的 ROM 开发者，本指南都将带你逐步上手 mGBA 的核心能力。从下载安装到调试器实操，覆盖新手到进阶的完整使用场景。
Quick Start
快速上手
五步即可完成 mGBA 的安装、加载 ROM 并开始游戏。建议初次使用先跟随本节顺序操作，熟悉后再深入更多进阶功能。
下载并安装
前往 下载中心 选择适合你操作系统的版本。Windows 用户推荐使用 64 位安装包；macOS 用户根据系统版本选择 modern（10.13+）或 legacy（10.9+）版本；Linux 用户可选择 AppImage 一键运行或 PPA 安装。下载完成后，按平台常规方式安装即可，无需任何额外依赖。
首次启动与界面
启动 mGBA 后将进入主窗口。菜单栏提供 File（文件）、Emulation（模拟）、Config（配置）、Tools（工具）、Help（帮助）等主要入口。新手最常用的路径是 File → Load ROM 加载游戏文件。第一次启动时建议前往 Config → Settings 检查音频、显示与控制器设置，确认默认配置符合你的硬件。
加载 ROM 文件
通过 File → Load ROM 选择 .gba / .gbc / .gb 文件，或直接将 ROM 文件拖拽到主窗口中即可启动游戏。mGBA 不会主动扫描你的 ROM 集合，建议把 ROM 文件整理到一个独立的目录，便于后续使用 Library 资源库视图统一管理。注意：请确保你拥有合法的游戏 ROM 来源（如正版卡带自备份）。
配置控制器
前往 Config → Settings → Input，可在"按键映射"中分别为 P1（玩家 1）配置方向键、A/B/L/R、Start/Select 共 10 个按键。mGBA 自动检测已连接的 Xbox / PlayStation / 通用 USB 控制器；如未识别，可在控制器选项中手动选择设备。每个按键都支持键盘与手柄双绑定，且可设置组合快捷键。
开始游戏
完成上述步骤后即可正式进入游戏。窗口标题栏会显示当前 ROM 名称、平台与运行帧率。游戏过程中可使用热键快速暂停、存档、回退或截图。如需全屏沉浸体验，按 F11 切换全屏模式；如需在多设备间无缝切换，建议为每个 ROM 设置独立的存档目录。
Cheats
金手指使用
mGBA 支持主流 GBA 金手指格式，并提供统一的金手指管理面板，方便玩家为每个 ROM 维护独立的金手指集合。
金手指面板使用
在 Tools → Cheats 中打开金手指管理面板。每个 ROM 的金手指列表独立保存，可随时启用、禁用、编辑或新增条目。面板支持分组、命名与注释，方便管理大量代码。修改金手指后无需重启游戏，mGBA 会即时应用。
使用注意事项
金手指可能触发游戏内的边界 bug 甚至破坏存档数据。建议启用前先创建存档快照备份；如出现异常，可通过 Rewind 回退到启用前状态，或加载之前的存档恢复。同时请勿在速通等正式记录场景下使用金手指。
金手指数据库导入
mGBA 支持导入 .cht 格式的金手指数据库文件，可批量载入社区维护的金手指集合。导入后可在面板中按游戏筛选启用所需条目，无需逐条粘贴，适合需要长期管理多款游戏的玩家。
Save Management
存档管理
mGBA 提供游戏内存档与即时存档（Save State）双系统，配合回退 Rewind 构成长短期组合，覆盖从日常备份到逐帧回退的完整需求。
游戏内存档
mGBA 自动模拟 GBA 的 SRAM / Flash / EEPROM 等存档芯片，游戏中保存进度会以 .sav 文件形式与 ROM 同名保存。退出游戏时 mGBA 自动刷新存档，确保进度不丢失。
多档位即时存档
通过 Emulation → Save State 可为每个 ROM 创建多达 9 档即时存档（Slot 1-9）。每档独立保存，并可通过热键瞬间加载，方便速通玩家在不同策略间快速切换试验。
回退 Rewind
开启 Rewind 后，按住 ` 键可让游戏逐帧回退到最近一段时间内的任意时刻。设置路径为 Config → Settings → Rewind。可调节缓冲长度与刷新间隔，平衡内存占用与回退跨度。
存档格式转换
0.9 版本起的内置转换工具可让 .sav 在不同格式（128KB / 256KB / EEPROM 等）间相互转换，是迁移旧模拟器存档、读卡器原始数据的核心工具。
自动存档
默认情况下，mGBA 在退出时自动写入游戏内存档；如希望进一步降低风险，可在配置中开启"周期性自动存档"，每隔 N 分钟写入一次快照。
备份与迁移
所有存档文件位于 mGBA 的用户数据目录（默认在用户主目录下的 mgba 文件夹）。直接备份此目录即可完整迁移到其他设备，保留所有 ROM 的进度、金手指与配置。
Debugger
调试器使用
面向 ROM 开发者与逆向研究者的专业调试工作流，覆盖从加载符号表到自动化测试的完整链路。
WORKFLOW
典型调试工作流
假设你正在开发一款自制 GBA ROM，并希望在 mGBA 中验证某个函数的行为是否正确。首先在 devkitARM 中编译 ROM，并附带 ELF / sym 符号文件。然后在 mGBA 中加载 ROM，通过 Tools → Debugger 打开调试器，使用 File → Load Symbols 加载符号表。接下来在反汇编视图中按符号名定位目标函数，设置入口断点，运行游戏直至断点命中。
命中断点后，可使用寄存器视图、内存查看器、调用栈等面板检视运行状态，配合 Step / Step Into / Step Over 进行单步跟踪。若需追踪某个内存地址被谁修改，可在该地址上设置写监视点，下次写入触发时调试器会暂停并显示写入指令的来源。
# 调试器工作流示例
(mgba) load game.elf
(mgba) break UpdatePlayer
BP#1 @ UpdatePlayer (0x08012A40)
(mgba) watch 0x03005000 w
WP#2 on write @ 0x03005000
(mgba) continue
Hit BP#1 PC=0x08012A40
R0=0x42 R3=0x03005000
(mgba) stepi ×3
Hit WP#2 PC=0x08012A6C
writing 0xFFFF → 0x03005000
(mgba) bt
0x08012A6C UpdatePlayer+0x2C
0x08012B70 GameStep+0x90
0x08012C80 MainLoop
反汇编器
提供 ARM / THUMB 双模式视图，可显示机器码、汇编指令与符号注释。支持搜索符号名、跳转到地址、设置标签，是 ROM 静态分析的核心入口。
内存查看器
支持 ASCII / Hex / Signed / Float 多视图切换，可同时监视多个地址区域。配合监视点可在内存被读写时立即暂停，定位变量被修改的源头。
寄存器面板
实时显示 R0-R15、CPSR、SPSR 与 IO 寄存器状态。任何寄存器值变更会以高亮提示，便于追踪上下文切换与中断行为。
Python 脚本
通过 Python 接口可编写自动化测试、批量分析与回归验证脚本，把日常的重复调试流程封装为一键命令，显著降低 ROM 开发的迭代成本。
Cheat 监控
在 Cheat 菜单中可启用"地址监控"模式，自动列出最近修改某内存地址的指令，帮助快速定位游戏内部变量与数据结构布局。
帧与时序分析
调试器可显示当前帧计数、PPU 状态、DMA 队列与中断时间轴，对分析渲染卡顿、音频断裂与时序 bug 极为有用。
Integrity
下载完整性校验
为防止第三方下载站点篡改安装包，建议在安装前对下载的文件进行 SHA-256 校验。下面给出在主流操作系统上校验的命令示例。
# Windows (PowerShell)
PS C:\Users\me\Downloads> Get-FileHash mGBA-0.10.5-win64.7z -Algorithm SHA256
# macOS / Linux
$ shasum -a 256 mGBA-0.10.5-macos-modern.dmg
$ sha256sum mGBA-0.10.5-x86_64.AppImage
# 与官方公布的校验和比对
$ diff <(echo "expected_hash mGBA-0.10.5-win64.7z") \
<(sha256sum mGBA-0.10.5-win64.7z) && echo "VERIFIED"
FAQ
常见问题
收集社区与用户最常询问的问题，覆盖性能、兼容性、存档与法律合规等高频话题。
mGBA 完全免费、开源（基于 MPL 2.0 协议），不包含任何广告、追踪代码或捆绑软件。所有官方构建均可从本站下载中心或 mGBA 官方 GitHub Releases 页面获取。如任何第三方站点请求付费、注册或额外安装，请勿信任。
ROM 的合法性因地区而异。一般原则是：仅加载你自己拥有的正版 GBA / GB / GBC 卡带通过读卡器自备份的镜像。请勿从互联网下载未经授权的商业游戏 ROM。社区维护的自制 ROM（Homebrew）与公开授权的开源游戏则可自由使用。
首先确认使用的是最新稳定版（0.10.5 或更高）。其次前往 Config → Settings 检查显示与音频设置：关闭画面滤镜可显著降低 CPU 负担；音频采样率建议保持 44.1 kHz。如果问题仅在特定 ROM 上出现，可在 GitHub Issue 中反馈并附带 ROM 名称、版本与复现步骤。
掌机平台均需先完成 Homebrew（自制软件）环境安装：Switch 推荐 Atmosphere 或 SX；3DS 使用 Luma3DS（仅 New 3DS 系列支持 mGBA）；Vita 使用 Henkaku 或 Enso 持久化；Wii 需安装 Homebrew Channel。完成 Homebrew 环境后，将对应平台的 mGBA 安装包拷贝至 SD 卡并通过 Homebrew 启动器加载即可。
游戏内存档（.sav）通常可跨模拟器互通，但不同模拟器可能使用不同的存档大小与字节序。mGBA 自 0.9 版本起内置存档转换工具，可在不同格式间互转。即时存档（Save State）则与具体模拟器绑定，无法跨模拟器使用。
金手指可能触发游戏内边界 bug 甚至破坏存档。如出现崩溃，先在金手指面板禁用最近启用的代码，再通过 Rewind 回退到启用前状态或加载之前的存档恢复。建议启用金手指前先创建即时存档快照作为安全点。
mGBA 从代码架构上更现代化、精度更高，在大量对时序敏感的 ROM 上表现明显更佳；同时提供完整的调试器、回退 Rewind、多平台覆盖（包括 Switch / 3DS / Vita / Wii 等）以及更稳定的长期维护。VBA-M 是基于 VBA 系列的社区延续分支，仍可作为兼容选项，但在新特性与精度上不如 mGBA。
mGBA 是基于 MPL 2.0 协议的社区项目，欢迎各类贡献。开发者可通过 GitHub Pull Request 提交修复与新特性；翻译者可参与界面本地化；测试者可在 Issue 区反馈 bug 与兼容性问题。详情可查看 关于 - 参与贡献 页面。
还没下载 mGBA？
立即下载 0.10.5 稳定版，按照本指南五步即可开始重温经典 GBA / GB / GBC 游戏。
