MAA 下载安装完整指南：3 分钟选对版本，装到能跑

MAA 下载安装完整指南：3 分钟选对版本，装到能跑

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

MAA 是《明日方舟》一键代打日常的小助手：基建换班、自动肉鸽、公招识别、战斗刷材料，它都能代劳。MAA 下载和安装最大的坑不在安装本身，而在选错版本——包和系统对不上，后面每一步都会卡。这篇文章用一张对照表加四个步骤，带你把 MAA 装到能跑。

先选对版本：一张表定位你的安装包

两个容易下错的点：

• 第三方加速站 Mirror酱没有 macOS 通用版，它只分拆 arm64 和 x86_64 两个包，下载前你得先确认 Mac 的芯片型号（苹果菜单 → 关于本机）。
• 官方完整包统一叫MAA-<版本号>-<平台>-<架构>，Releases 页里其他命名的文件都是"零部件"，单独下回来没用。
• Windows 最省事的路径是包管理器：winget install maa，不用解压也不用装运行库，装完直接输入maa就能启动。默认装在C:\Users\用户名\AppData\Local\Microsoft\WinGet\Packages。

MAA 安装主流程：确认架构 → 下载 → 安装 → 启动

第 1 步：确认架构

✅ Windows 基本不用纠结，选 x64 就对了；arm64 包是专门给 Windows 二合一设备用的，普通台式机/笔记本选了也跑不起来。

macOS 更省事：universal 通用版同时内置 Intel 和 Apple Silicon 两套原生代码，两种芯片通吃，不用查机型。

Linux 和服务器场景跳过这一节，直接看 maa-cli。

第 2 步：下载

下载前看一眼文件名，对上MAA-<版本>-<平台>-<架构>的格式才算完整包。

下载来源只认四类：官网、GitHub Releases、Winget、官方 QQ 群文件（群入口在项目文档站里）。渠道不限，但来源要可信——自动化软件本来就容易触发杀软启发式检测，来路不明的包会让你分不清是误报还是真有问题。

第 3 步：安装 / 解压

Windows：把 zip完整解压到一个你有写权限的普通目录，比如桌面或D:\MaaAssistantArknights。别解压到C:\根目录或C:\Program Files\这类需要管理员权限的系统目录——MAA 运行时要往自己所在目录写配置、日志和缓存，写不进去的后果是各种查不出原因的闪退和报错。

macOS：双击 .dmg，把MAA.app拖进 /Applications，拖完就装完了 ✅

命令行：装好 maa-cli 之后跑一条maa install，它会自动下载官方预编译的 MaaCore 和识别资源（maa-cli 本身只是壳，真正干活的是 MaaCore）。

第 4 步：启动

• Windows：先以管理员身份运行 MAA 目录里的 DependencySetup_依赖库安装.bat 装好运行库，再双击MAA.exe。这一步别跳过，跳过的代价见下文"运行库缺失"。
• macOS：直接从"启动台"或 /Applications 打开 MAA，没有额外依赖要装。
• 命令行：maa install跑完后即可发起任务。

启动成功的样子长这样：左边勾日常任务，右边看实时日志。

平台细节

Windows：30 秒装好 VC++ 运行库，以及系统版本要求

MAA 虽然把 .NET 运行时打进了包里（自包含部署，不用你单独装），但 C++ 核心库仍依赖系统里的 Visual C++ 运行库。

技术角落：那个DependencySetup_依赖库安装.bat本质就是一条 winget 命令，作用是静默修复安装Microsoft.VCRedist.2015+.x64（不弹窗、不强制重启、先卸旧版）。你完全可以在管理员终端里手动跑同一条命令，效果一样：

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

脚本还处理了 winget 不存在的场景：如果终端提示'winget' is not...，说明系统版本太老，按提示去微软官方地址手动下载vc_redist.x64.exe安装即可。

系统版本方面划几条线：

• 只支持 Windows 10/11，32 位系统和 Win 7/8/8.1 都在门外。
• Windows N/KN 版（欧洲/韩国版）要额外装媒体功能包，否则部分功能不可用。
• 运行库安装依赖系统组件存储服务（CBS/TrustedInstaller/WinSxS），这些组件如果被"精简系统"破坏，除了重装没有可靠的修复办法——这也是不建议用来源不明的精简版系统的原因。

另外，MAA 声明的 UAC 级别是asInvoker（见 app.manifest），也就是它本来就不需要管理员身份。你不需要"右键以管理员运行 MAA.exe"，真正需要管理员的只有装运行库那一步；反过来，它被放进受保护目录导致写不进去，才是闪退的常见来源。

macOS：通用版为什么通吃 Intel 和 Apple Silicon

"universal" 不是营销词。构建脚本 build_macos_universal.zsh 会分别以 arm64 和 x86_64 各跑一轮完整的 CMake 构建，再用 xcframework 把两份产物合并进同一个 .app。所以你的 Mac 拿到的永远是原生二进制，不存在 Rosetta 转译那一层。

一个合理预期：macOS 版由团队里少数开发者维护，和 Windows 端 WPF 界面相比功能可能有差异或滞后，装之前心里有数。

maa-cli 安装：Linux 与服务器场景

MAA 的图形界面目前只覆盖 Windows 和 macOS，Linux 上要用 maa-cli——它是纯命令行版本，支持 Linux / macOS / Windows，非常适合脚本自动化和服务器。完整文档见 maa-cli 安装及编译。

安装方式挑顺手的：

• 官方一键脚本：Linux/macOS 用curl -fsSL .../install.sh | bash，Windows PowerShell 用install.ps1；
• 包管理器：brew install MaaAssistantArknights/tap/maa-cli（Homebrew）、paru -S maa-cli或yay -S maa-cli（Arch/AUR）、nix run nixpkgs#maa-cli（Nix）；
• Rust 开发者源码编译：

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

装完后记住两件事：

1. 无论哪种装法，运行任务前都要maa install拉取 MaaCore 和资源（Nix 用户例外：Nix 包已强制依赖 MaaCore，不用也不该手动装）。
2. 从源码编译的话，最低支持 Rust 版本（MSRV）是 1.88，直接用最新工具链最省心。

Windows 用户如果走 maa-cli 路线，在maa install之前要先装好上面那条 VC++ 运行库（管理员权限跑 winget 命令即可），和 GUI 版的要求完全一致。

高频坑与自查

下一步

• 首次使用：走一遍 新手上路——确认系统版本和模拟器支持情况，把模拟器分辨率设为横屏1280x720或1920x1080（美服玩家必须1920x1080），再完成初始连接配置。
• 了解 MAA 都能干什么：功能介绍，覆盖自动基建换班、自动肉鸽、公招识别、自动战斗等。
• 卡住了：查 常见问题，置顶的运行库条目覆盖了绝大多数启动失败场景。

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