MAA 下载安装完整指南：如何在 Windows、macOS 与命令行一次装好 MaaAssistantArknights-育师

MAA 下载安装完整指南：如何在 Windows、macOS 与命令行一次装好 MaaAssistantArknights

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

MAA（MaaAssistantArknights）是《明日方舟》的日常自动化工具：登录、刷材料、公招，一次点完。这篇 MAA 下载安装教程带你核对系统、选对软件包，完成 Windows / macOS / Linux 下的首次成功启动，并学会自查常见启动故障，读完即可独立装好并跑起 MAA。

🧭 动手前 30 秒判断：系统、架构、来源三个问题

下载之前，先问自己三个问题：

你的 Windows 是 10 / 11 吗？MAA 在 Windows 下只支持 10 和 11，32 位系统与 Windows 7 / 8 / 8.1 均不支持；Windows N/KN（欧洲/韩国版）需另装媒体功能包。
你的芯片 / 架构是什么？Windows 常规为 x64，对应win-x64包；arm64 设备对应win-arm64包，两者不可混用。Mac 则要分清 Apple Silicon 与 Intel，这决定后面拿哪份包，别凭感觉猜。
下载来源是否可靠？官网、GitHub Releases、Winget、官方 QQ 群文件、Mirror酱这几条路都走得通；来路不明的第三方站点请绕开。

官方包的文件名都遵循固定格式：MAA-<版本>-<平台>-<架构>.zip。下载前把文件名里的平台和架构与上面的答案对一遍，再开始传输。

📥 三条下载路径：选对架构，或一条命令装好

路径 A｜官网 / GitHub Releases 直下：Windows 取 win-x64，macOS 取 universal 版

官网会识别访问者的系统并给出推荐版本，多数 Windows 用户直接取推荐的MAA-<版本>-win-x64.zip即可。从 GitHub Releases 手动下载时则要自己核对：Windows 取win-x64，别误拿win-arm64；macOS 取MAA-<版本>-macos-universal.dmg。

这个 Universal 通用版不是噱头：查看构建脚本 build_macos_universal.zsh，它对 arm64 与 x86_64 分别做了完整的 CMake 构建和安装，再交给 xcframework 的 makefile 合并产物，两种芯片上执行的都是原生代码。

第三方渠道有两点注意：

Mirror酱是独立的第三方下载加速服务，需付费订阅 CDK 使用，收费与 MAA 本身无关。它不提供 macOS 通用版，先确认芯片：Apple Silicon 选 arm64，Intel 选 x86_64。
QQ 群文件：加入 MAA 官方 QQ 群（入口在项目文档站可以找到），从群文件下载最新软件包，与官网内容对等。

路径 B｜MAA winget 一条命令安装，maa-cli 也能走包管理器

Windows 用户可以连解压、装运行库的步骤都省掉，在 PowerShell 或 CMD 中执行：

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

其中--source winget表示只从 winget 源查找，可避开部分代理、加速器环境下 Microsoft Store（msstore）源证书校验失败（错误码0x8a15005e）导致的中止。装好后在命令行输入maa即可启动，默认安装路径为C:\Users\用户名\AppData\Local\Microsoft\WinGet\Packages。

有一个坑要提前说：若机器上还装着 maa-cli，两边都会响应maa命令，需要自行区分。想通过包管理器装 maa-cli，brew、paru、nix 各有现成命令：

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；Nix 还有每夜构建，细节见 maa-cli 安装文档。

路径 C｜maa-cli 安装命令：预编译脚本、包管理器、cargo 编译三条子路线

MAA 图形界面暂未支持 Linux，Linux 及其他系统的用户、无头服务器与自动化场景，应选择命令行工具 maa-cli（支持 Linux、macOS、Windows）。它有三条子路线：

预编译脚本：推荐。在 Linux/macOS 用 bash、Windows 用 PowerShell 执行官方安装脚本即可一键装好（具体命令见 maa-cli 安装及编译文档），之后随时可用maa self update更新自身。
包管理器：即路径 B 中列出的 brew / paru / nix 命令，不重复展开。
cargo 编译：Rust 开发者可用cargo install从 maa-cli 源码自行构建，完整命令见上述安装文档。注意其最低支持 Rust 版本（MSRV）为 1.88，且可能随时变化，建议始终使用最新工具链。

最后一件事：maa-cli 只提供命令行界面，真正跑任务还需要 MaaCore 及资源。预编译或自行编译的版本执行maa install，即可自动拉取官方预编译的 MaaCore：

maa install

平台差异有两点：Windows 用户须先以管理员身份装好 VC++ 运行库，再执行maa install；Nix 用户依赖已内置，无需也不应手动安装 MaaCore。

📦 从文件到第一次成功启动：Windows 解压要点与 macOS 三步装

Windows：完整解压，先修运行库再双击 MAA.exe

下载完得到.zip，用解压缩软件将其完全解压，你会拿到一个包含 MAA 全部文件的文件夹，双击其中的MAA.exe即启动。

位置有一条硬性约束：不要放进需要 UAC 提权的目录，例如C:\根目录、C:\Program Files\。原因很直接——MAA 要往自己所在目录写配置、缓存与日志，而MAA.exe的清单声明的是asInvoker级别，即以你当前的权限运行、不请求提权；放进受保护目录反而因写入失败而表现异常。

运行库方面：MAA 采用自包含部署，.NET 运行时已内置，不用另装；系统层面的 VCRedist x64（Visual C++ 运行库）仍然需要。请在解压后的 MAA 目录中以管理员身份运行 DependencySetup_依赖库安装脚本。它的工作是借助 winget 静默修复Microsoft.VCRedist.2015+.x64包，完成后重启电脑，再启动 MAA。若系统版本过老没有 winget，脚本会给出备用的手动下载链接。

macOS：下载、打开、拖入，三步完成

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

提前管理一个预期：macOS 版由团队中少数开发者维护，功能可能与 Windows 端存在差异或滞后，部分 UI 层实现的功能（如库存保持、定时执行）在 macOS 上不一定可用。

🩹 启动失败、闪退怎么办？按症状自查清单

安装与启动阶段的高频问题集中在几种固定套路，逐条对照：

双击 MAA.exe 闪退，或弹出报错窗口？多半是 VC++ 运行库没更新。以管理员身份重跑依赖库安装脚本，完成后重启电脑再试。
解压后的文件夹看着"不全"，程序起不来？你拿到的可能是"零部件"包。完整安装包命名为MAA-<版本>-<平台>-<架构>.zip，其余文件无法单独使用；重新下载完整的MAA-<版本>-win-x64.zip，避开win-arm64版。
版本升级后，原有配置、日志全没了？重装后忘了搬旧目录。把旧文件夹里的config、data、debug复制到新目录，cache与achievement可选保留。
杀软报警，MAA 文件被隔离？自动化工具容易触发启发式检测，误报并不等于存在恶意行为。先确认来源可信，再把安装目录加入白名单、向安全厂商提交误报；不建议直接关闭实时防护。
启动时弹出"安装文件缺失"？MAA 启动时会对照清单文件filelist.txt校验完整性，该提示说明部分文件被安全软件拦截或删除了。到隔离区恢复文件，或在弹窗中选择自动修复重新下载完整包。

单条没解决的话，常见问题里有更完整的说明，置顶的运行库部分覆盖了大多数启动失败场景。

收尾：装好之后，下一步去哪

MAA 下载安装的全流程就这些：核对架构 → 选渠道取包 → 按平台完成安装 → 出问题对着清单自查。启动成功后，建议接着做三件事：

配置模拟器：分辨率设为横屏1280x720或1920x1080，美服（YostarEN）玩家必须用1920x1080，然后按新手上路完成初始配置；
了解功能：自动基建换班、自动肉鸽、公招识别、自动战斗等能力，都在功能介绍里；
命令行玩法：maa-cli 的用法细节与 MaaCore 安装，见 maa-cli 安装及编译文档。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考