下载与安装新手
确认适用系统
| 系统 | Windows | macOS |
|---|---|---|
| 系统版本 | Windows 10 及以上 | macOS 15.0 及以上 |
| 运行环境 | 需要 | 需要 |
| 模拟器支持 | 支持 | 支持 |
| 安装包名 | MaaYuan-win-x86_64-vXXX.zip | MaaYuan-macos-aarch64-vXXX.tar.gz |
WARNING
MaaYuan当前仅支持Windows x64与macOS Apple Silicon（aarch64）。- Windows 端只提供
x86_64安装包，不支持 Windows ARM。 - macOS 目前仅支持 Apple Silicon（
aarch64）安装包；Intel Mac 暂不支持。 - 若你使用的是 Intel Mac，可优先考虑 Windows 10+ 环境下使用 Windows 版
MaaYuan与模拟器。 - Linux、Android、iOS 以及其他未知平台当前均不支持。
下载渠道说明
- 【最省事】Mirror酱下载，详细介绍请查阅【常见问题-Mirror酱是什么】。
- 【第一手】GitHub下载，需要科学上网，如果喜欢
MaaYuan，请在项目右上角点亮Star支持。 - 【最多选】网盘下载↓↓，AI抓取Github后网盘分流，更新不一定及时。
正在识别当前系统与架构；若未自动推荐，可直接展开下方下载渠道手动选择安装包。
已有 Mirror酱 CDK？ 前往 Mirror酱 高速下载
解压安装
Windows
- 正确解压到独立文件夹，勿拆分文件。
- 避免路径含中文，推荐非系统盘，例如
D:\MaaYuan。 - 不要直接解压到
C:\或C:\Program Files\，否则可能涉及管理员权限问题。
macOS
- 正确解压到独立文件夹，勿拆分文件。
- 尽量避免路径含中文。
- 下载目录可以作为临时解压位置，但正式使用仍建议放在独立目录。
安装运行环境（依赖库）
| 系统 | Windows | macOS |
|---|---|---|
| 依赖库主要安装步骤 | 打开MaaYuan文件夹右键点击DependencySetup_依赖库安装_win.bat选择“以管理员身份运行” | 打开MaaYuan文件夹点击“新建位于文件夹位置的终端窗口”或点击启动台-其他-终端输入指令 sh DependencySetup_依赖库安装_mac.sh |
| 若依赖库安装失败 | 下载VCRedist：点击 vc_redist.x64 下载并安装完成；下载NET10：点击.NET 官方下载页面选择 .NET 桌面运行时-Windows x64进行下载并安装完成。 | 无需下载VCRedist；下载NET10：点击.NET 官方下载页面选择 .NET运行时-macOS Arm64进行下载并安装完成。 |
版本变化提醒
从 v2.0.0 起，MaaYuan 需要 .NET 10 及以上运行库，原来的 .NET 8 已不再满足要求。
下一步
安装完成后，请继续阅读：