MaaAssistantArknights 如何安装部署：Windows、macOS、Linux 与 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）替你把《明日方舟》的登录、刷材料、公招、基建换班这些每天重复点几十次的活接管了，省掉的是盯模拟器、排队点按钮、记哪关刷过哪关没刷的整套重复劳动。它覆盖 Windows 与 macOS 的图形界面（GUI），以及 Linux、macOS、Windows 三平台通用的 maa-cli 命令行形态，本文按"环境核对 → 落地路径 → 跑通动作 → 启动排错"的顺序，给到能独立装完、配好、跑通第一个日常、并排掉常见启动故障的完整路径。
环境匹配矩阵：该拿哪个文件
| 平台 | 芯片 / 架构 | 最低系统版本 | 对应发布包命名规则 |
|---|---|---|---|
| Windows | x64 | Windows 10（x64） | MAA-<版本>-win-x64.zip |
| Windows | ARM64 | Windows 11 on ARM | MAA-<版本>-win-arm64.zip |
| macOS | Apple Silicon（arm64）/ Intel（x86_64） | 见 GitHub Releases 对应包 | MAA-<版本>-macos-universal.dmg（双架构通用） |
| Linux | x64 / arm64 | 无头服务器或桌面均可，GUI 不支持 | 通过 maa-cli 使用，无独立 GUI 包 |
三点特殊情况先记住：Windows N/KN 版（欧洲/韩国）需另装媒体功能包。
三条落地路径：按省事程度排
路径 A｜零配置：包管理器 / 一键脚本
Windows（winget）
winget install --id MaaAssistantArknights.MaaAssistantArknights --exact --source winget验证：命令行输入maa --version有版本输出即装好（--source winget指定只走 winget 源，可避开代理环境下msstore源证书校验失败，错误码0x8a15005e）。
macOS / Linux（brew、paru、nix）
brew install MaaAssistantArknights/tap/maa-cli paru -S maa-cli nix run nixpkgs#maa-cli验证：maa --version。
⚠️ 最高频坑：winget / brew 装完 GUI 或 CLI 后，启动前还要先修 VC++ 运行库（见下一节），跳过这一步大概率闪退。
路径 B｜手动下载：官网 / Releases
- 进官网或 GitHub Releases 下载页，对照上表选包——官网会自动推荐正确架构，手动下载则必须自己核对文件名里的
平台-架构与本机一致。 - Windows：完整解压 zip，得到含
MAA.exe的文件夹；macOS：双击.dmg，把MAA.app拖进/Applications。 - Windows 唯一硬性约束：别把 MAA 放进需要 UAC 提权的目录（
C:\根、C:\Program Files\等）——MAA 的 UAC 级别是asInvoker，本就不需要管理员身份，放进受保护目录反而会因无法写入config/cache/debug而表现异常。
⚠️ 最高频坑：在 ARM 芯片机器上错拿了 x64 包，或反之，启动即闪退且无任何提示。
路径 C｜源码编译：面向有构建环境的用户
入口：仓库根 CMakeLists.txt（C++ 主程序，CMake ≥ 3.24），maa-cli（Rust 部分）MSRV 为 1.88，建议始终用最新工具链；macOS 通用包由 tools/build_macos_universal.zsh 对arm64与x86_64各做一轮完整 CMake 构建后合并，两种芯片上都是原生运行。Nix 用户的依赖已内置，无需手动处理。
⚠️ 最高频坑：工具链低于 MSRV 直接编译失败，先升级 Rust / CMake 再谈其他。
装完到跑通之间还差什么
- Windows：以管理员身份双击
DependencySetup_依赖库安装.bat（位于tools/目录）修复 VC++ 运行库→ MAA 采用自包含部署已内置 .NET 运行时，但系统层的 VCRedist x64 仍依赖，脚本本质是静默修复Microsoft.VCRedist.2015+.x64包 → 完成后重启，再启动MAA.exe不再闪退即通过。 - maa-cli：运行
maa install拉取 MaaCore 与游戏资源→ maa-cli 只是命令行界面，跑任务必须有 MaaCore → 终端执行maa --version与maa主菜单均正常返回即通过；Nix 用户依赖已内置，跳过此步。 - 把模拟器分辨率设为横屏
1280x720或1920x1080，美服（YostarEN）玩家必须1920x1080→ MAA 的模板匹配基于固定分辨率训练，错分辨率会导致识别全乱 → 模拟器内确认分辨率后，MAA 首次启动能自动检测到模拟器即通过。 - 首次启动 MAA 后按引导完成「连接设置」→ MAA 通过 ADB 与模拟器通信，首次启动会引导自动检测 → 在「MAA 设置 → 连接设置」看到已连接的模拟器条目，且「近 30 次截图耗时」有数值即通过。
- 勾选一个任务（如「开始唤醒」）点「开始」，看日志区滚动→ 这是最小闭环验证 → 日志区出现任务条目并最终显示「完成」即跑通。
启动排错：以「你看到的现象」为锚点
现象：双击MAA.exe闪退，或弹出报错窗口根因：VC++ 运行库未更新（FAQ 置顶就是它，出现率最高）。 动作：以管理员身份重跑tools/DependencySetup_依赖库安装.bat，或在终端执行下面这行后重启：
winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /norestart" --uninstall-previous --accept-package-agreements --force现象：解压后的文件夹"看着不全"，找不到MAA.exe或目录结构不对根因：下成了拆分后的"零部件"包，不是完整安装包。 动作：重新从官网或 Releases 拿完整MAA-<版本>-win-x64.zip，勿选win-arm64版。
现象：杀软报警，MAA.exe被隔离根因：自动化工具触发杀毒软件启发式检测，误报并不一定代表恶意行为。 动作：确认下载来源（官网 / GitHub Releases / Winget / 官方 QQ 群文件）可信后，去隔离区恢复文件并把安装目录加白名单；同时向安全厂商提交误报样本，不建议直接关实时防护。
现象：启动时弹「安装文件缺失」根因：启动时 MAA 对照filelist.txt做文件清单完整性校验，部分文件此前被安全软件拦过。 动作：到安全软件隔离区恢复被删文件，或在弹窗里选「自动修复」（会重新下载完整包并在重启后恢复）。
现象：Windows N/KN 版启动失败或媒体相关功能异常根因：N/KN 版系统默认不带媒体组件。 动作：安装微软官方的媒体功能包后重启。
以上都没命中：查 docs/zh-cn/manual/faq.md（置顶的运行库部分覆盖了绝大多数启动失败场景），或在 MAA 内「设置 → 问题反馈 → 生成日志压缩包」带上日志去 GitHub Issues 反馈；若完全无法启动，手动把debug/config/cache三个文件夹打包后一并提供。
下一步去哪
- 首次配置模拟器连接与初始任务：docs/zh-cn/manual/newbie.md
- 想看 MAA 能干什么（自动基建换班、自动肉鸽、公招识别、自动战斗等）：docs/zh-cn/manual/introduction/README.md
- maa-cli 的安装、编译与 MaaCore 更新细节：docs/zh-cn/manual/cli/install.md
【免费下载链接】MaaAssistantArknights《明日方舟》小助手，全日常一键长草！| A one-click tool for the daily tasks of Arknights, supporting all clients.项目地址: https://gitcode.com/GitHub_Trending/ma/MaaAssistantArknights
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
