macOS 搭建 Flutter 开发环境（一）：SDK、PATH 与国内镜像
2026-09-10 修订：原文基于 Flutter 1.22 与 macOS Catalina。本次按当前官方资料整理安装、PATH 和镜像配置，保留原网址；这次未在 macOS 设备完成安装实测，不将旧终端输出当作当前版本验证结果。
在 Mac 上安装 Flutter，先让命令行找到正确的 SDK，再按目标平台安装 Android 或 iOS 工具。不要一开始就把所有平台和编辑器都装齐。
1. 选择 SDK 安装方式
从 Flutter 安装入口 选择手动安装或编辑器引导安装。手动下载时，根据 Intel 或 Apple Silicon 选择相应架构，并遵循当前系统要求。本文以下以解压后的 SDK 放在 ~/develop/flutter 为例。
如果习惯 Homebrew，可查看 Flutter cask。不要再使用旧写法 brew cask install。下面只是包管理器的另一条安装路线，不要与已有手动安装混用：
brew install --cask flutter2. 配置 PATH
手动安装后，在终端运行以下命令临时启用 SDK；路径必须与你实际解压目录一致。
export PATH="$HOME/develop/flutter/bin:$PATH"
command -v flutter
which -a flutter需要永久生效时，将该 export 行加入你实际使用的 shell 配置；zsh 可按官方 PATH 指南使用 ~/.zprofile，已有配置则避免重复追加。重新打开终端，或加载对应文件后检查路径。Homebrew 管理的安装使用它创建的链接，不额外添加另一个 SDK 路径。
3. 在需要时配置受信任镜像
网络无法顺利获取 Flutter 构建产物或 Dart 包时，可参考官方中国网络说明。下面使用其中列出的社区镜像，服务可用性仍取决于提供者与网络：
export PUB_HOSTED_URL="https://pub.flutter-io.cn"
export FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"这些变量不会替代 GitHub 源码下载，也不会自动修复 Android SDK、Gradle 或其他仓库的连接。先定位哪一层请求失败，再调整对应配置。持久化时写入实际 shell 配置，并重开终端。
4. 验证 SDK，而不是复制旧输出
flutter --version
dart --version
flutter doctor -v记录实际 Flutter/Dart 版本和 doctor 结果。若出现多个 SDK，先处理 PATH 顺序；下载超时则检查错误日志中实际请求的域名。
5. 按目标平台继续配置
只开发 Web 时，不需要为了 doctor 全绿就安装 Android 与 iOS 全部工具。开发 Android 请继续配置 Android Studio、SDK和设备；开发iOS需要兼容的Xcode环境。