在 macos 上安装 flutter sdk 需下载 zip 包、解压至 ~/development/、将 $home/development/flutter/bin 加入 ~/.zshrc 的 path 并 source 生效，最后通过 flutter --version 和 flutter doctor 验证。
在 macOS 上安装 Flutter SDK 并配置好环境变量，核心是下载 SDK、解压到固定路径、将 bin 目录加入 PATH，再验证是否生效。关键在于终端配置文件（如 zshrc）是否正确修改并重载，以及 Flutter 自带的依赖检查是否通过。
下载并解压 Flutter SDK
前往 Flutter 官网下载页，选择 macOS 版本的 stable channel ZIP 包（如 flutter_macos_arm64.zip 或 flutter_macos_x64.zip，根据你的芯片类型选）。下载完成后执行：
- 打开终端，进入下载目录（例如：
cd ~/Downloads） - 解压到常用位置，推荐
~/development/：unzip flutter_macos_*.zip -d ~/development/ - 确认解压后存在
~/development/flutter/bin/flutter文件
配置环境变量（PATH）
macOS 默认使用 zsh，需编辑 ~/.zshrc（若用 bash 则为 ~/.bash_profile）：
- 运行
open -e ~/.zshrc打开编辑器 - 在文件末尾添加一行：
export PATH=$PATH:$HOME/development/flutter/bin - 保存并关闭，然后在终端中执行：
source ~/.zshrc（使配置立即生效） - 验证是否写入成功：
echo $PATH | grep flutter—— 应能看到 flutter 路径
验证 Flutter 命令与环境检查
运行以下命令逐项确认：
-
flutter --version：应输出版本号（如Flutter 3.22.2），说明命令已识别 -
which flutter：应返回/Users/xxx/development/flutter/bin/flutter -
flutter doctor：检查开发环境，首次运行会自动下载必要工具（如 Dart、CocoaPods 等）
→ 若提示 Xcode 或 Android Studio 缺失，按提示安装即可；
→ 若出现[!] Android toolchain，说明仅需 Android 开发才需补全，纯 iOS 开发可忽略该警告
常见问题速查
如果 flutter 命令仍提示 command not found：
- 确认
~/.zshrc中的路径拼写无误（比如$HOME是否手误为$HOME/多斜杠） - 确认终端是新开的，或已执行
source ~/.zshrc - 检查 Flutter 解压路径是否含空格或中文（建议全程使用英文路径）
- 运行
ls -l ~/development/flutter/bin/确认flutter文件存在且有可执行权限（如无，执行chmod +x ~/development/flutter/bin/flutter）
