mGBA Logo mGBA

故障排除指南

本指南提供使用 mGBA 时遇到的常见问题和故障的解决方案。如果您遇到此处未涵盖的问题，请查看 FAQ 部分或在 GitHub 上报告问题。

常见问题和解决方案

游戏无法加载或 ROM 无法加载

问题：

游戏 ROM 文件无法加载或 mGBA 无法识别该文件。

解决方案：

  1. 验证 ROM 文件是否为有效的 Game Boy Advance ROM（.gba 格式）
  2. 检查文件是否损坏 - 如果可能，尝试重新下载
  3. 如果 ROM 在 ZIP 存档中，请先解压
  4. 确保 ROM 文件未损坏或不完整
  5. 尝试加载不同的 ROM 以验证 mGBA 是否正常工作
  6. 检查文件权限（确保 mGBA 可以读取该文件）

低 FPS 或性能问题

问题：

游戏运行缓慢或帧跳过。

解决方案：

  1. 启用硬件加速（OpenGL、Vulkan、Direct3D 11 或 Metal）
  2. 减少分辨率缩放（尝试 1x 或 2x 而不是更高的缩放）
  3. 启用自动跳帧
  4. 关闭其他占用资源的应用程序
  5. 更新图形驱动程序到最新版本
  6. 检查您的硬件是否满足最低要求
  7. 尝试不同的渲染后端（如果硬件失败，使用软件）

音频卡顿或爆音

问题：

游戏过程中音频卡顿、爆音或跳音。

解决方案：

  1. 在 设置 → 音频 中增加音频缓冲区大小
  2. 降低采样率（如果 44.1 kHz 导致问题，尝试 32 kHz）
  3. 如果已启用，禁用跳帧
  4. 关闭其他音频应用程序
  5. 检查音频驱动程序是否最新
  6. 尝试不同的音频后端
  7. 减少其他应用程序的 CPU 使用率

存档文件不工作

问题：

游戏存档无法保存或未创建存档文件。

解决方案：

  1. 确保 mGBA 在其目录中具有写入权限
  2. 如果需要，以管理员权限运行 mGBA（Windows）
  3. 验证 ROM 和存档文件名完全匹配
  4. 检查存档目录不是只读
  5. 检查可用磁盘空间（磁盘空间不足可能阻止保存）
  6. 验证存档类型检测是否正确（EEPROM、Flash、SRAM）
  7. 如果自动检测失败，手动设置存档类型

图形故障或视觉伪影

问题：

图形损坏、故障或显示不正确。

解决方案：

  1. 在不同的渲染后端之间切换（OpenGL、Vulkan、Direct3D、Metal）
  2. 如果 VSync 导致问题，禁用它
  3. 更新图形驱动程序到最新版本
  4. 如果硬件加速导致问题，尝试软件渲染
  5. 禁用自定义着色器或过滤器
  6. 将视频设置重置为默认值
  7. 检查特定游戏是否有已知的兼容性问题

游戏手柄或控制器不工作

问题：

游戏手柄或控制器未被检测到或控件不工作。

解决方案：

  1. 在启动 mGBA 之前连接游戏手柄
  2. 转到 设置 → 输入 → 游戏手柄 进行配置
  3. 点击每个按钮以重新映射控件
  4. 在控制器连接的情况下重新启动 mGBA
  5. 检查游戏手柄是否被您的操作系统识别
  6. 尝试不同的 USB 端口（用于 USB 控制器）
  7. 更新游戏手柄驱动程序
  8. 使用其他应用程序测试游戏手柄以验证其是否工作

连接线模拟不工作

问题：

多人游戏或连接线模拟无法连接。

解决方案：

  1. 在加载游戏之前在 工具 → 连接线 中启用连接线模拟
  2. 确保两个实例都加载了相同的游戏
  3. 如果使用网络模式，检查防火墙设置
  4. 验证两个实例都在同一网络上（本地网络模式）
  5. 检查网络连接的 IP 地址配置
  6. 尝试重新启动两个 mGBA 实例
  7. 确保游戏支持连接线多人游戏

作弊码不工作

问题：

作弊码不起作用或导致崩溃。

解决方案：

  1. 验证作弊码格式是否与游戏版本匹配
  2. 检查作弊码是否适用于正确的游戏和地区
  3. 确保作弊码已启用（勾选复选框）
  4. 尝试在开始游戏之前加载作弊码
  5. 验证作弊码格式（GameShark、Action Replay、CodeBreaker）
  6. 某些作弊码可能需要特定的游戏状态才能工作

mGBA 崩溃或冻结

问题：

mGBA 崩溃、冻结或变得无响应。

解决方案：

  1. 更新到最新版本的 mGBA
  2. 更新图形驱动程序
  3. 检查系统日志中的错误消息
  4. 禁用自定义着色器或过滤器
  5. 将配置重置为默认值
  6. 检查可用内存（内存不足可能导致崩溃）
  7. 验证 ROM 文件未损坏
  8. 在 GitHub Issues 上报告崩溃及错误详细信息

平台特定问题

Windows

  • Visual C++ 运行时错误： 安装 Visual C++ Redistributable
  • DirectX 错误： 更新 DirectX 运行时库
  • 权限错误： 以管理员身份运行或调整文件夹权限
  • 防病毒软件阻止： 将 mGBA 添加到防病毒软件白名单

macOS

  • "应用已损坏"错误： 移除隔离属性： xattr -d com.apple.quarantine mGBA.app
  • Gatekeeper 警告： 在 系统偏好设置 → 安全 中允许应用
  • Metal 错误： 更新到最新的 macOS 版本

Linux

  • 缺少库： 安装所需的依赖项（SDL2、Qt5 等）
  • 权限错误： 检查文件权限和所有权
  • 图形问题： 更新 Mesa 驱动程序或专有 GPU 驱动程序

获取帮助

如果您无法解决您的问题：

  • 检查主网站上的 FAQ 部分
  • 在现有的 GitHub Issues 中搜索类似问题
  • 创建一个新的 GitHub Issue，包含：
    • 问题的详细描述
    • 重现问题的步骤
    • 您的系统规格（操作系统、CPU、GPU）
    • mGBA 版本
    • 错误消息或日志（如果可用）

相关文章

有关 mGBA 配置和使用的更多信息：