如果是第一次使用 MAA，请阅读新手上路。

注意

若 MAA 在某次更新后无法运行，或者单纯是从 MAA 的报错窗口来到这的，那八成是由于运行库未更新导致的问题。
出现次数最多的问题都是运行库问题，而总是有人看不到文档到处问，所以我们把置顶换成了这个。很气。

MAA 已采用自包含部署方式，内置了 .NET 运行时，但仍需要 Visual C++ 运行库。

请运行 MAA 目录下的 DependencySetup_依赖库安装.bat，或在终端中运行以下命令，

winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /norestart" --force --uninstall-previous --accept-package-agreements

或手动下载并安装以下运行库来解决问题。

• Visual C++ 可再发行程序包

软件无法运行/闪退/报错

下载/安装问题

• 完整 MAA 软件压缩包命名格式为 "MAA-版本-平台-架构.zip"，其余均为无法单独使用的“零部件”，请仔细阅读。 在大部分情况下，您需要使用 x64 架构的 MAA，即您需要下载 MAA-*-win-x64.zip，而非 MAA-*-win-arm64.zip。
• 如果在某次自动更新后发现功能缺失或无法使用，可能是自动更新过程中出现了问题。请重新下载并解压完整安装包。解压后，将旧 MAA 文件夹中的 config、data 与 debug 文件夹复制到新解压的 MAA 文件夹中，以保留原有配置和日志；cache（缓存）与 achievement（通关截图）文件夹可选保留。

运行库问题

找到网页右下角的向上 ↑ 箭头，点一下它。

系统问题

• MAA 不支持 32 位操作系统，不支持 Windows 7 / 8 / 8.1。
• 以上运行库安装均需要依赖组件存储服务（CBS、TrustedInstaller/TiWorker、WinSxS）。 如果组件存储服务被破坏，将不能正常安装。

我们无法提供除重装系统以外的修复建议，请避免使用未标明精简项及精简风险的“精简版”系统，或者万年前的旧版系统。

Windows N/KN

对于 Windows N/KN（欧洲/韩国），还需安装媒体功能包。

Windows 7 / 8 / 8.1

由于 MAA 依赖的运行库和系统组件要求 Windows 10 及以上版本，MAA 不再支持 Windows 7 / 8 / 8.1 系统。

被 Windows Defender / 杀毒软件误报（PUA / 病毒）

• 请先确认下载来源可信，仅使用官网、GitHub Releases、Winget 或官方群文件；并确认下载的是完整安装包（如 MAA-<版本>-win-x64.zip）。
• 自动化工具可能会触发部分杀毒软件的启发式检测，出现误报并不一定代表软件存在恶意行为。
• 若确认来源可信，建议向对应安全厂商提交误报样本，等待其病毒库修正。
• 在等待修正期间，可临时将 MAA 安装目录加入杀毒软件白名单；不建议直接关闭系统实时防护。

启动时提示 ｢安装文件缺失｣

MAA 启动时会对照安装包自带的文件清单（filelist.txt）检查安装文件是否缺失。若弹出此提示，说明部分文件被安全软件拦截、删除，或被手动删除，对应功能（如小游戏等任务）可能无法运行：

• 若为安全软件所致，请前往其隔离区找回并恢复被删除的文件，并将 MAA 安装目录加入白名单。
• 也可在弹窗中选择自动修复（重新下载完整包并在重启后恢复），或按弹窗内的说明手动重装。

DLL 注入问题

MAA 启动时弹出悲报，或出现闪退、界面渲染异常，通常是 Nahimic 等第三方软件向 MAA 注入了 DLL 导致的。可通过以下任一方法解决：

方法一：通过 Windows 安全中心阻止 DLL 注入（推荐）

1. 打开 Windows 安全中心 → 应用和浏览器控制 → 攻击防护 → 攻击防护设置 → 程序设置
2. 点击 添加程序进行自定义，选择 ｢按程序名称添加｣ 并输入 MAA.exe（也可选择 ｢选择确切的文件路径｣ 后定位到 MAA 安装目录下的 MAA.exe）
3. 在 MAA 的设置列表中找到 ｢禁用扩展点｣，勾选 ｢替代系统设置｣ 并打开开关
4. 点击 ｢应用｣ 保存，然后重启 MAA

该设置从系统层面阻止第三方软件向 MAA 注入 DLL，不会影响其他程序的正常运行。

方法二：重命名注入的 DLL

1. 在弹窗给出的路径下找到对应的 DLL 文件（若看不到文件扩展名或该文件，需先在资源管理器顶部 查看 → 显示 中勾选 ｢文件扩展名｣ 和 ｢隐藏的项目｣）
2. 右键该文件 → 重命名，将扩展名 .dll 改为 .dll1 等无效扩展名

注意

该方法可能导致相关程序出错，请谨慎使用。想了解问题原因可查看相关动态和 blog。

方法三：处理相关软件

尝试将 MAA 加入相关软件的排除名单，或直接卸载相关软件后检查问题是否仍然存在。

连接错误

确认 ADB 及连接地址正确

参阅 连接设置。

关闭现有 ADB 进程

关闭 MAA 后查找 任务管理器 - 详细信息 中有无名称包含 adb 的进程，如有，结束它后重试连接。

正确使用多个 ADB

当 ADB 版本不同时，新启动的进程会关闭旧的进程。因此在需要同时运行多个 ADB，如 Android Studio、Alas、手机助手时，请确认它们的版本相同。

避免游戏加速器

部分加速器在启动加速和停止加速之后，都需要重启 MAA、ADB 和模拟器再连接。

同时使用 UU 加速器 和 MuMu 可以参考官方文档。

重启电脑

重启能解决 97% 的问题。（确信

换模拟器

请参阅 模拟器和设备支持。

连接正常，但是无操作

小部分模拟器自带的 ADB 版本过于老旧，不支持 Minitouch、MaaTouch。

请使用管理员权限打开 MAA，关闭模拟器并重启 MAA 后点击 MAA 设置 - 连接设置 - 强制替换 ADB。

模拟器更新后可能会重新覆盖 ADB 文件。若更新后问题复现，请再次尝试替换，或使用 其他 ADB。

连接正常，但是操作卡顿、异常或频繁出错

• 若使用了 异形屏UI适配，请将其调整为 0。
• 若正在游玩非国服客户端，请先在 设置 - 游戏设置 - 客户端类型 中选择客户端版本。非国服部分功能可能并非完全适配，请参阅对应的外服使用文档。
• 若正在进行自动肉鸽，请参阅 自动肉鸽文档，并在 自动肉鸽 - 肉鸽主题 中正确选择主题。
• 若自动战斗频繁暂停且不下干员，请关闭 设置 - 运行设置 中的 划火柴模式。
• 若自动编队无法正常识别干员，请取消对应干员的特别关注。
• Adb Input 触控模式操作缓慢为正常情况，如需自动战斗等请尝试切换其他模式。
• 若正在使用 MuMu 模拟器，请勿将 显存使用策略 设置为 资源占用更小。

提示截图用时较长 / 过长

• MAA 目前支持 RawByNc 、 RawWithGzip 、 Encode 三种基于 ADB 的截图方式，当执行任务平均截图耗时 >400 / >800 时会输出一次提示信息（单次任务只会输出一次）。
• 设置 - 连接设置 中会显示近 30 次截图耗时的 最小/平均/最大值，每 10 次截图刷新。
• 自动战斗类功能（如自动肉鸽）受截图耗时影响较大。
• 此项耗时与 MAA 无关，与电脑性能、当前占用或模拟器相关，可尝试清理后台/更换模拟器/升级电脑配置。

管理员权限相关问题

MAA 理应无需以 Windows UAC 管理员权限运行即可实现所有功能。现与管理员权限有关的功能主要包括：

1. 自动检测连接：当目标模拟器以管理员身份运行时需要管理员权限。
2. 完成后关闭模拟器：当目标模拟器以管理员身份运行时需要管理员权限。
3. 开机自动启动 MAA：无法在管理员身份下设置开机自启。
4. 当 MAA 被错误解压到需要管理员权限进行写入的路径时，例如 C:\、C:\Program Files\。

有报告称关闭了 UAC 的系统存在“即使没有右键选择管理员运行也会以管理员权限启动”的问题，建议开启 UAC 以避免意料之外的提权行为。

下载到一半提示“登录”/“鉴权”

请使用 浏览器 / IDM / FDM 等下载器下载文件，不要用 ↑↓ 迅雷！

编辑此页