MAA 安装指南：3 步选对安装包，Windows、macOS 到 maa-cli 一次装通

【免费下载链接】MaaAssistantArknights《明日方舟》小助手，全日常一键长草！| A one-click tool for the daily tasks of Arknights, supporting all clients.项目地址: https://gitcode.com/GitHub_Trending/ma/MaaAssistantArknights

MaaAssistantArknights（MAA）是《明日方舟》的日常自动化工具，登录、刷材料、做公招这些重复劳动可以一键交给它。这篇 MAA 下载安装指南覆盖 Windows、macOS 与 maa-cli 三条路线，读完你能独立选对下载包、装通软件，并自查大部分安装报错。

MAA 的日常职能用一句话说清：替你盯着模拟器，到点把"开始行动"按下去。所以安装主线也只有三步——先定包型，再按平台走流程，最后做验收。

📦 三个问题定包型：你的系统该下载哪一份 MAA 安装包

在打开任何下载页之前，先回答三个问题。官方发布包统一采用MAA-<版本>-<平台>-<架构>.zip命名，答案直接决定文件名：

1. 操作系统是什么？决定是拿 GUI 安装包还是 maa-cli。
2. 架构是什么？架构指 CPU 的指令集版本，装错架构的软件无法运行。Windows 默认按 x64 处理；Mac 要先确认芯片是 Apple Silicon（arm64）还是 Intel（x86_64），两者的包不通用。
3. 要图形界面还是纯命令行？图形界面（GUI）目前只支持 Windows 和 macOS；Linux 等系统走命令行工具 maa-cli。

对照表：

两条前置门槛写在前面：MAA 不支持 32 位系统与 Windows 7 / 8 / 8.1；Windows N/KN 版需要另装媒体功能包。Windows 用户也别顺手拿win-arm64包——不同架构的安装包不能混用，文件名里的架构和你的 CPU 对不上，装上也起不来。

🖥️ Windows MAA 安装：完整解压、避开 UAC 目录、先修 VC++ 运行库

下载渠道：官网、GitHub Releases、Winget 与群文件

• 官网：自动识别访问者系统并推荐正确版本，多数人按推荐拿到MAA-<版本>-win-x64.zip即可，最省事。

• GitHub Releases：手动下载，需自己核对架构与文件名。

• Winget：命令行直装，免去手动解压，装完还能在终端输入maa启动：

  winget install --id MaaAssistantArknights.MaaAssistantArknights --exact --source winget

  --source winget限定只从 winget 源查找，可避免部分网络环境下 msstore 源证书校验失败（错误码0x8a15005e）导致安装中止。有一个坑：如果你机器上同时装了 maa-cli，两者都会响应maa命令而互相打架，需要额外步骤区分。

• Mirror酱：第三方付费下载加速服务（CDK 订阅制，并非 MAA 收费），Windows 侧选 x64 即可。

• 官方 QQ 群文件：群入口可在项目文档站找到，群文件里拿最新软件包。

解压位置有一条硬规矩

1. 把 zip完整解压，得到一个包含 MAA 全部文件的文件夹；只解压出零散文件的"零部件"包无法单独使用，程序会起不来。
2. 放置时避开C:\根目录、C:\Program Files\这类需要 UAC 提权的目录。原因是 MAA 需要往自己所在目录写config、data、debug等配置与日志文件，而它的 UAC 级别是asInvoker（随调用者权限运行、不请求管理员身份），放进受保护目录会因写入失败表现异常。
3. 在 MAA 目录中以管理员身份运行 DependencySetup_依赖库安装.bat，修复系统层面的 VC++ 运行库。
4. 双击MAA.exe启动。

VC++ 运行库：装完它再启动 MAA.exe

MAA 采用自包含部署，.NET 运行时已内置，不需要另装；但 Visual C++ 运行库（VCRedist x64）属于系统级依赖，仍要补。脚本本质是一条静默修复命令，跑完后重启电脑再启动 MAA：

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

如果系统老到没有 winget，脚本会给出备用的手动下载地址。若运行库反复装不上，多半是系统的组件存储服务（CBS、WinSxS）已损坏，精简版系统上基本无解，可参阅 常见问题 的系统问题部分。

macOS MAA 安装：Universal 通用版 dmg 的三步操作

1. 下载MAA-<版本>-macos-universal.dmg；
2. 双击打开该 dmg；
3. 把MAA.app拖进/Applications文件夹。

官网会直接给 Mac 用户推荐 Universal 通用版。它是货真价实的双架构产物：构建脚本 build_macos_universal.zsh 会先对arm64与x86_64各做一轮完整的 CMake 构建与安装，再由 xcframework.makefile 合并两者——在两种芯片上都是原生运行，而非转译，所以不用纠结自己是什么芯片。

只有走 Mirror酱这类渠道时才需要自己确认芯片：它不提供通用版，Apple Silicon 选 arm64、Intel 选 x86_64，选错就装不上。另请有预期：macOS 版由团队中少数开发者维护，功能可能与 Windows 端存在差异或滞后。

🐧 Linux 与无头服务器：maa-cli 命令行版的三条安装路线

MAA 的 GUI 暂不支持 Linux，替代方案是 maa-cli，它支持 Linux、macOS 与 Windows，适合自动化与无头服务器场景。完整方法见 maa-cli 安装及编译文档，三条路线任选其一：

1. 预编译二进制：用官方安装脚本一键安装（Linux/macOS 走 bash，Windows 走 PowerShell），装完可用maa self update更新自身。

2. 包管理器：

   brew install MaaAssistantArknights/tap/maa-cli paru -S maa-cli nix run nixpkgs#maa-cli

   brew 另有预发行版maa-cli-beta；Arch 用户也可以用yay -S maa-cli代替paru。

3. cargo 从源码编译：Rust 开发者的选择：

   cargo install --git https://github.com/MaaAssistantArknights/maa-cli.git --bin maa --tag stable --locked

   注意 maa-cli 的最低支持 Rust 版本（MSRV）为 1.88，且 MSRV 可能随时变化，所以建议始终使用最新工具链。

装完 maa-cli 还要补 MaaCore

maa-cli 只提供了一个命令行界面，真正跑任务还需要 MaaCore 及资源：

• 预编译或自行编译的用户：执行maa install自动拉取官方预编译的 MaaCore。
• Windows 用户：执行前需先以管理员身份装好 VC++ 运行库（命令同上一节的 winget 命令），再运行maa install。
• Nix 用户：依赖已内置，无需也不应手动安装 MaaCore。

🩺 MAA 打不开或提示文件缺失？按现象查原因再动手

安装阶段的高频问题基本是固定套路，每条按"现象 → 原因 → 处置"拆开：

• 双击MAA.exe闪退或弹出报错窗口原因：VC++ 运行库没更新——MAA 虽内置了 .NET 运行时，但仍依赖 VCRedist。 处置：以管理员身份重跑 DependencySetup_依赖库安装.bat，完成后重启电脑。
• 解压完程序起不来，文件看着"不全"原因：下到的不是完整软件，而是无法单独使用的"零部件"包。 处置：重新下载完整MAA-<版本>-win-x64.zip，勿选win-arm64版。
• 版本升级或重装后，原有配置、日志全没了原因：新目录没有搬运旧数据。 处置：将旧MAA文件夹中的config、data、debug复制到新目录，cache（缓存）与achievement（通关截图）可选保留。
• 杀软报警，MAA 文件被隔离原因：自动化工具容易触发启发式检测，误报并不等于恶意行为。 处置：确认下载来源可信（官网、GitHub Releases、Winget、官方群文件），将安装目录加入白名单，并向安全厂商提交误报样本；不建议直接关闭实时防护。
• 启动时弹窗提示"安装文件缺失"原因：MAA 启动时对照安装包自带的filelist.txt清单做完整性校验，文件被安全软件拦截或删除就会触发。 处置：到安全软件隔离区找回并恢复文件，或在弹窗中选择自动修复（重新下载完整包）。

✅ 装完怎么算成功：验收清单与下一步文档入口

验收：怎么判断 MAA 已经装好

• Windows：双击MAA.exe能进入主界面，左侧任务勾选区、右侧运行日志区都正常显示，即安装成功：

• maa-cli：maa install成功拉取 MaaCore 及资源，maa self update能正常执行。

装完之后去哪

• 第一次使用，去 新手上路：确认模拟器支持情况，把模拟器分辨率设为横屏1280x720或1920x1080（美服玩家必须1920x1080），再按指引完成初始配置。

• 想看 MAA 能干什么（自动基建换班、自动肉鸽、公招识别、自动战斗等），翻 功能介绍。

• 安装中遇到问题，先查 常见问题——置顶的运行库部分覆盖了绝大多数启动失败场景。

• maa-cli 的用法细节与 MaaCore 安装，见 maa-cli 安装及编译。

• 文档站支持五种语言，按需切换：

【免费下载链接】MaaAssistantArknights《明日方舟》小助手，全日常一键长草！| A one-click tool for the daily tasks of Arknights, supporting all clients.项目地址: https://gitcode.com/GitHub_Trending/ma/MaaAssistantArknights