Flutter命令未找到是因SDK未正确安装或PATH未配置，推荐用Homebrew自动安装；中国大陆用户可选清华镜像Git克隆并配置zshrc；也可官网下载ZIP手动解压配置，最后均需运行flutter doctor验证环境。
如果您在 macOS 上尝试搭建 Flutter 开发环境，但执行 flutter 命令时提示“command not found”，则很可能是 Flutter SDK 未正确下载、解压或 PATH 环境变量未配置生效。以下是多种可靠且经验证的安装方法：
一、通过 Homebrew 安装 Flutter（推荐）
Homebrew 是 macOS 最主流的包管理工具，使用它可自动处理依赖、简化更新流程，并避免手动配置 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，使配置立即生效。
三、从 Flutter 官网下载 ZIP 包并解压配置
该方法完全离线可控，适用于无 Homebrew 或 Git 环境、或需指定特定历史版本（如 v3.22.3-stable）的开发者。解压后需手动配置路径与镜像，确保后续 pub 获取和插件下载正常。
1、访问 Flutter 官网归档页：https://docs.flutter.dev/install/archive?tab=macos，选择匹配芯片架构（arm64 或 x64）的稳定版 ZIP 包下载。
2、解压至目标目录（例如）：unzip ~/Downloads/flutter_macos_3.22.3-stable.zip -d ~/development/。
3、确认 shell 类型：echo $SHELL；若输出 /bin/zsh，则编辑 ~/.zshrc；若为 /bin/bash，则编辑 ~/.bash_profile。
4、追加以下两行至配置文件：
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
5、追加 Flutter bin 路径：export PATH="$PATH:$HOME/development/flutter/bin"。
6、重载配置：source ~/.zshrc（或对应配置文件）。
四、验证与基础检查
无论采用哪种安装方式，都必须运行 flutter doctor 进行完整性校验。该命令会检测 Xcode、Android Studio、iOS 工具链等关键组件状态，并高亮缺失项。
1、首次运行：flutter doctor。
2、若提示 Android SDK 缺失命令行工具，执行：sdkmanager --install "cmdline-tools;latest"（需先配置 ANDROID_HOME）。
3、若提示 Xcode 许可未接受，运行：sudo xcodebuild -license accept。
4、若提示 libimobiledevice 等 iOS 工具缺失（Apple Silicon Mac 常见），执行：brew install --HEAD libimobiledevice ideviceinstaller ios-deploy。
5、检查输出中所有条目前的符号：✅ 表示就绪，❌ 表示需干预，⚠️ 表示建议操作。
