MAA 下载安装：从拿到正确的包到第一次跑通

MAA 下载安装：从拿到正确的包到第一次跑通

【免费下载链接】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 10 以上，还是 macOS？图形界面只有这两个系统有。Linux 或其他系统的话，你只能走命令行路线。

你想要能看见的界面，还是命令行就够了？前者要完整的 MAA 安装包，后者只需要 maa-cli 一个可执行文件。这个问题直接决定下一步你拿哪个包。

你打算从哪儿拿？官网、GitHub Releases、还是系统包管理器，都是官方渠道。渠道定了，就可以开始下载。

二、拿到正确的包 📦

MAA 怎么装，先看路线。

GUI 路线（Windows、macOS）

官方包命名是MAA-<版本>-<平台>-<架构>.zip。MAA 下载哪个版本？Windows 用户默认选MAA-<版本>-win-x64.zip，别误拿win-arm64的。Mac 用户选 universal 通用版，Apple Silicon 和 Intel 都能原生跑，别猜，直接拿通用版。

渠道三选一：

• 官网：自动推荐对的架构，最省事。
• GitHub Releases：自己下包，对着文件名核对架构。
• Winget（仅 Windows）：不用手动解压，不用装运行库：

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

一条命令装好 MAA。--source winget把查找限定在 winget 源，避免 Microsoft Store 源证书校验失败。

CLI 路线（maa-cli）

如果你是 Linux 用户，或者想在无头服务器上跑 MAA，走这条。maa-cli 支持 Linux、macOS、Windows。

最省事是官方一键安装脚本，Linux/macOS 走 bash，Windows 走 PowerShell，见 maa-cli 安装及编译文档。装完可以用maa self update保持最新。

有包管理器的系统可以直接：

brew install MaaAssistantArknights/tap/maa-cli paru -S maa-cli

第一行是 Homebrew（macOS 和 Linux 通用），第二行是 Arch（yay 同理）。Nix 用户直接nix run nixpkgs#maa-cli。Rust 开发者也可以源码编译，MSRV 为 1.88，建议用最新工具链。

三、从安装到第一次启动

如果你是用 Winget 装的，直接跳到本节最后一步。否则按顺序来。

1. 落到磁盘上

• Windows：把 zip 完整解压，出来的就是含 MAA 全部文件的文件夹。位置只有一条硬规则——别放进需要 UAC 提权的目录（如C:\根目录、C:\Program Files\）。坑在这：MAA 要往自己目录写配置、缓存、日志。它以asInvoker权限运行，本就不需要管理员，放进受保护目录反而写入失败。
• macOS：双击.dmg，把MAA.app拖进/Applications，安装完成。

2. 装依赖

• Windows：.NET 运行时已内置，不用另装。但 VCRedist x64（Visual C++ 运行库）仍需要。在 MAA 目录中以管理员身份运行 DependencySetup_依赖库安装.bat，它会静默修复运行库。系统没有 winget 时，脚本会给出手动下载链接。
• macOS：无额外依赖。

3. 首次启动

重启电脑，双击MAA.exe。看到下面这个界面，MAA 就算就绪了：

maa-cli 稍有不同

命令行工具只是界面，真正跑任务还需要 MaaCore 和资源：

maa install

一键拉取官方预编译的 MaaCore 及资源。如果你是 Windows，先以管理员身份装好 VC++ 运行库：

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

静默修复 VC++ x64 运行库，再执行maa install。Nix 用户 MaaCore 已内置，跳过此步。

四、跑不起来，对一下这几条 🩹

起不来别慌，按症状对号入座。

双击MAA.exe闪退，或弹出报错原因：VC++ 运行库没更新，闪退最常见的原因。 动作：在 MAA 目录里以管理员身份重跑DependencySetup_依赖库安装.bat，完成后重启。

解压后文件夹看着"不全"，程序起不来原因：你下的是"零部件"包，不是完整软件。 动作：重新下载完整MAA-<版本>-win-x64.zip，认准完整包命名。

升级后配置、日志全没了原因：重装后没把旧目录搬过去。 动作：把旧文件夹的config、data、debug复制到新目录；cache、achievement可选。

杀软报警，MAA 文件被隔离原因：自动化工具容易触发启发式检测，不代表有恶意问题。 动作：确认下载来源可信，把 MAA 目录加入安全软件白名单，向厂商报误报。别随手关实时防护。

启动时提示"安装文件缺失"原因：启动时filelist.txt校验发现文件被安全软件拦截或删除。 动作：去安全软件隔离区恢复文件，或在弹窗里选自动修复重下完整包。

五、接下来做什么

先读 新手上路：确认系统与模拟器支持情况，把模拟器设成横屏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