MAA 安装怎么搞？Windows / macOS / 命令行，三步跑通
项目地址: https://gitcode.com/GitHub_Trending/ma/MaaAssistantArknights MaaAssistantArknights（下称 MAA）是《明日方舟》的日常自动化工具：登录、刷材料、做公招，一次点击。跟着做完，Windows、macOS、命令行三个平台你都能独立装好，安装报错也多半能自己定位。
🧭 MAA 安装前，确认三件事
动手前，先问自己三个问题。一，系统够不够新：Windows 要 10 及以上，32 位系统和 Win7/8 不支持，Mac 用能跑当前 MAA 的版本即可。二，芯片是什么：Windows 大多是 x64，Mac 要分清 Apple Silicon 还是 Intel。架构就像钥匙和锁，配错了包就打不开，因为不同架构的二进制文件指令集不同。三，包从哪来：官网、GitHub Releases、Winget、官方群文件都算数，来路不明的第三方别碰。说白了，后面遇到的多数安装坑，都出在这三件事没确认上。
📦 Windows 下 MAA 该下哪个包、放到哪
下载 官网拿 MAA-<版本>-win-x64.zip，图省事也可以用 Winget 包管理器装。 坑：别拿 win-arm64 包，不同架构指令集不同，不能混用。
放到哪 完整解压出来。 坑：别放 C:\ 根目录或 Program Files。MAA 要往自己目录写配置，又不提权，放受保护目录会写入失败。
怎么跑 双击 MAA.exe。 坑：.NET 已内置，VC++ 运行库仍需修。启动闪退就在目录里以管理员身份重跑 DependencySetup_依赖库安装.bat，装完重启。
🍎 macOS 选 arm64 还是 x86_64
下载 MAA-<版本>-macos-universal.dmg。通用版是货真价实的双架构产物，两种芯片都是原生运行。 坑：第三方加速站不提供通用版，先看芯片，arm64 还是 x86_64，别猜。
放到哪 双击 dmg，把 MAA.app 拖进 /Applications。 坑：拖完即装好。没有安装向导，光看不拖等于没装。
怎么跑 从应用程序启动 MAA.app。 坑：macOS 版维护人手少，功能可能滞后于 Windows 端，先有这个预期。
⌨️ maa-cli 命令行安装：预编译、包管理器、源码编译
下载 Linux 和 macOS 一键脚本装：
curl -fsSL https://raw.githubusercontent.com/MaaAssistantArknights/maa-cli/main/install.sh | bash
包管理器路线也行，比如 brew install MaaAssistantArknights/tap/maa-cli。 坑：maa-cli 只是命令行界面，跑任务还得有 MaaCore 和资源。
放到哪 它自己装进系统路径，不用手动摆。 坑：若同时装了 maa-cli 与 winget 版 MAA，两者都响应 maa 命令，注意区分。
怎么跑 执行 maa install 拉取 MaaCore 与资源后即可跑任务。 坑：Windows 用户先以管理员装好 VC++ 运行库，Rust 编译需 1.88 以上工具链。
第一次启动检查
启动后，你应该看到任务勾选区和运行日志区，左上角版本号就是刚下载的版本；不该看到报错弹窗、“安装文件缺失”提示，或者窗口一开就闪。顺手游览一遍模拟器连接，没问题就算跑通了。
踩坑速查
遇到：双击 MAA.exe 闪退，或弹出报错窗口 因为：VC++ 运行库缺失或没更新 做：在 MAA 目录以管理员重跑 DependencySetup_依赖库安装.bat，完成后重启电脑
遇到：解压完程序起不来，文件夹看着“不全” 因为：拿到的是“零部件”包，不是完整软件 做：重新下载完整 MAA-<版本>-win-x64.zip，完整解压
遇到：版本升级后，原有配置、日志全没了 因为：重装后没把旧目录搬过去 做：把旧文件夹的 config、data、debug 复制到新目录，cache 和 achievement 可选
遇到：杀软报警，MAA 文件被隔离 因为：自动化工具触发启发式检测，属于误报 做：确认来源可信，把安装目录加白名单，并向安全厂商提交误报
遇到：启动时弹“安装文件缺失” 因为：filelist.txt 完整性校验被触发，文件被安全软件拦截或删除 做：去安全软件隔离区恢复文件，或在弹窗里选自动修复重下完整包
接下来去哪
- 新手上路 —— 确认系统、模拟器支持与分辨率，按指引完成初始配置
- 功能介绍 —— 自动基建换班、自动肉鸽、公招识别，看看它都能干什么
- maa-cli 安装及编译 —— 命令行用法细节与 MaaCore 安装，无头服务器场景看这里
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
