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

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/MaaAssistantArknightsMaaAssistantArknightsMAA是《明日方舟》的日常自动化工具登录、刷材料、做公招这些重复劳动可以一键交给它。这篇 MAA 下载安装指南覆盖 Windows、macOS 与 maa-cli 三条路线读完你能独立选对下载包、装通软件并自查大部分安装报错。MAA 的日常职能用一句话说清替你盯着模拟器到点把开始行动按下去。所以安装主线也只有三步——先定包型再按平台走流程最后做验收。 三个问题定包型你的系统该下载哪一份 MAA 安装包在打开任何下载页之前先回答三个问题。官方发布包统一采用MAA-版本-平台-架构.zip命名答案直接决定文件名操作系统是什么决定是拿 GUI 安装包还是 maa-cli。架构是什么架构指 CPU 的指令集版本装错架构的软件无法运行。Windows 默认按 x64 处理Mac 要先确认芯片是 Apple Siliconarm64还是 Intelx86_64两者的包不通用。要图形界面还是纯命令行图形界面GUI目前只支持 Windows 和 macOSLinux 等系统走命令行工具 maa-cli。对照表操作系统芯片架构该拿哪一份Windows 10 / 11绝大多数为 x64MAA-版本-win-x64.zip或直接用 Winget 安装macOSApple Siliconarm64或 Intelx86_64MAA-版本-macos-universal.dmg通用版两种芯片都原生运行Linux、无头服务器不区分maa-cli 命令行工具两条前置门槛写在前面MAA 不支持 32 位系统与 Windows 7 / 8 / 8.1Windows 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 群文件群入口可在项目文档站找到群文件里拿最新软件包。解压位置有一条硬规矩把 zip完整解压得到一个包含 MAA 全部文件的文件夹只解压出零散文件的零部件包无法单独使用程序会起不来。放置时避开C:\根目录、C:\Program Files\这类需要 UAC 提权的目录。原因是 MAA 需要往自己所在目录写config、data、debug等配置与日志文件而它的 UAC 级别是asInvoker随调用者权限运行、不请求管理员身份放进受保护目录会因写入失败表现异常。在 MAA 目录中以管理员身份运行 DependencySetup_依赖库安装.bat修复系统层面的 VC 运行库。双击MAA.exe启动。VC 运行库装完它再启动 MAA.exeMAA 采用自包含部署.NET 运行时已内置不需要另装但 Visual C 运行库VCRedist x64属于系统级依赖仍要补。脚本本质是一条静默修复命令跑完后重启电脑再启动 MAAwinget install Microsoft.VCRedist.2015.x64 --override /repair /passive /norestart --uninstall-previous --accept-package-agreements --force如果系统老到没有 winget脚本会给出备用的手动下载地址。若运行库反复装不上多半是系统的组件存储服务CBS、WinSxS已损坏精简版系统上基本无解可参阅 常见问题 的系统问题部分。macOS MAA 安装Universal 通用版 dmg 的三步操作下载MAA-版本-macos-universal.dmg双击打开该 dmg把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 安装及编译文档三条路线任选其一预编译二进制用官方安装脚本一键安装Linux/macOS 走 bashWindows 走 PowerShell装完可用maa self update更新自身。包管理器brew install MaaAssistantArknights/tap/maa-cli paru -S maa-cli nix run nixpkgs#maa-clibrew 另有预发行版maa-cli-betaArch 用户也可以用yay -S maa-cli代替paru。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 还要补 MaaCoremaa-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-climaa 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考