推荐通过Homebrew安装Flutter：先检查或安装Homebrew，再执行brew install --cask flutter并验证版本；中国大陆用户可选清华镜像手动配置SDK；Apple Silicon Mac需启用Rosetta 2；必须安装Xcode并配置命令行工具；最后运行flutter doctor完成环境检测。
一、通过 Homebrew 安装 Flutter（推荐）
Homebrew 是 macOS 上最主流的包管理工具，使用它安装 Flutter 可以自动处理依赖、简化更新流程，并避免手动配置 PATH 的常见错误。该方式适用于已安装 Homebrew 且网络环境稳定（或已配置镜像）的用户。
1、检查是否已安装 Homebrew：在终端中执行 brew --version，若返回版本号则跳过下一步；否则执行安装命令。
2、安装 Homebrew（如未安装）：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"。
3、添加 Dart 官方仓库并安装 Dart（可选，Flutter 自带 Dart）：brew tap dart-lang/dart && brew install dart。
4、安装 Flutter：brew install --cask flutter。
5、验证安装：flutter --version，成功将显示当前 Flutter 版本号。
二、从清华镜像手动下载并配置 SDK
针对中国大陆用户，直接访问官方服务器常因网络限制失败。使用清华大学镜像源可显著提升下载成功率与速度，并确保 SDK 完整性。此方法不依赖 Homebrew，适合离线部署或需精确控制 SDK 版本的场景。
1、创建开发目录并进入：mkdir -p ~/development && cd ~/development。
2、从清华镜像克隆稳定版 Flutter SDK：git clone https://mirrors.tuna.tsinghua.edu.cn/git/flutter-sdk.git flutter -b stable。
3、编辑 shell 配置文件（macOS Catalina 及更新系统默认为 zsh）：nano ~/.zshrc。
4、在文件末尾添加三行环境变量：
export PUB_HOSTED_URL=https://mirrors.tuna.tsinghua.edu.cn/dart-pub
export FLUTTER_STORAGE_BASE_URL=https://mirrors.tuna.tsinghua.edu.cn/flutter
export PATH="$PATH:$HOME/development/flutter/bin"
5、保存后执行：source ~/.zshrc，使配置立即生效。
三、配置 Rosetta 2（Apple Silicon Mac 必须）
搭载 M1/M2/M3 芯片的 Mac 在运行部分 Flutter 工具链（如某些 iOS 构建工具、模拟器组件）时需通过 Rosetta 2 进行指令集转译。若跳过此步，后续 flutter doctor 可能报错“xcrun: error: invalid active developer path”或无法启动 iOS 模拟器。
1、在终端中执行启用命令：sudo softwareupdate --install-rosetta --agree-to-license。
2、输入管理员密码后等待安装完成（无需重启）。
3、验证 Rosetta 是否启用：打开“活动监视器”，查找任意进程，在“Kind”列中确认存在“Intel”标识即表示已生效。
四、安装并配置 Xcode 及 iOS 开发支持
Xcode 提供 iOS 编译器、模拟器、签名工具及命令行工具（xcode-select），是运行和调试 iOS 应用的必备依赖。即使仅开发 Android 或 Web，Flutter Doctor 仍会检查其是否存在。
1、从 App Store 安装最新版 Xcode（约 12 GB），安装完成后启动一次以完成初始化。
2、在终端中设置命令行工具路径：sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer。
3、接受许可协议：sudo xcodebuild -license accept。
4、下载 iOS 模拟器组件：xcodebuild -downloadPlatform iOS。
5、启动模拟器验证：open -a Simulator。
五、验证与基础检查（flutter doctor）
flutter doctor 是 Flutter 提供的环境自检命令，它将逐项扫描 SDK、平台工具、证书、依赖等状态，并以 ✔️ 或 ✗ 标识结果。该命令必须在完成前述任一安装方式并正确配置 PATH 后执行，是确认环境是否就绪的关键步骤。
1、在终端中运行：flutter doctor。
2、若提示缺少 Android 工具链，但你暂不开发 Android 应用，可忽略对应项；若需支持，按提示安装 Android Studio 并配置 ANDROID_SDK_ROOT。
3、若出现 “Missing plugins” 类提示（如 CocoaPods、libimobiledevice），按输出建议逐条执行修复命令，例如：sudo gem install cocoapods 或 brew install libimobiledevice。
4、全部项显示 ✔️ 后，执行 flutter doctor -v 查看详细版本与路径信息。
