运行flutter doctor可诊断Flutter环境配置，检查SDK、Dart、Xcode、Android Studio等依赖状态；若报command not found，需核查.zshrc或.bash_profile中PATH设置是否正确并执行source生效。
要确认Mac终端中Flutter SDK是否已正确加载并能被系统识别，最直接有效的方式就是运行诊断命令查看当前环境的完整反馈。
运行flutter doctor检查整体配置
在终端中输入并执行：flutter doctor
该命令会逐项扫描Flutter SDK本身、Dart SDK、Xcode、Android Studio、iOS工具链、Android工具链等依赖项。每项状态用图标表示：✅ 表示就绪，❌ 表示缺失或异常，⚠️ 表示需手动干预。
如果命令报错 command not found: flutter，说明环境变量未生效或SDK路径配置错误，需立即返回检查 .bash_profile 或 .zshrc 中的 PATH 设置。
验证Flutter和Dart二进制是否可调用
分别执行以下两条命令：
flutter --version
dart --version
前者输出类似 Flutter 3.22.2 • channel stable • https://github.com/flutter/flutter.git，后者应显示 Dart SDK 版本（如 Dart SDK version: 3.4.4）。【若 dart 命令失败但 flutter 成功，说明 Flutter 自带的 Dart 未被 PATH 覆盖，但独立 Dart 安装可能冲突】
确认环境变量是否已载入当前会话
第一步：检查当前 shell 类型，执行 echo $SHELL；macOS Catalina 及之后默认为 /bin/zsh，旧系统可能是 /bin/bash。
第二步：根据 shell 类型，查看对应配置文件是否包含 Flutter 路径：
→ 若是 zsh：执行 cat ~/.zshrc | grep "flutter/bin" 或 cat ~/.bash_profile | grep "flutter/bin"（部分用户仍沿用 bash 配置）
→ 若是 bash：执行 cat ~/.bash_profile | grep "flutter/bin"
第三步：确认 PATH 中实际生效的路径，运行 echo $PATH | tr ':' '\n' | grep flutter。只要输出中出现类似 /Users/xxx/Documents/flutter/bin 的路径，即表示 SDK 目录已成功注入环境。
快速定位常见失败原因
方法一：检查 Flutter SDK 文件夹是否存在且权限正常
进入你配置的 Flutter 路径（例如 cd ~/Documents/flutter），执行 ls -l bin/flutter。若提示 No such file or directory，说明路径写错或 SDK 未解压完成。
方法二：确认配置文件是否被重新加载
编辑完 .bash_profile 或 .zshrc 后，必须执行 source ~/.zshrc（或对应文件）才生效。新开终端窗口不会自动继承旧会话的 PATH，除非该配置已写入 shell 初始化文件并被正确 source 过。
方法三：排查芯片架构匹配问题
在终端运行 uname -m，返回 arm64 却安装了 x86_64 版本的 Flutter SDK，会导致 flutter 二进制无法执行（报 Bad CPU type in executable）。此时需删除原 SDK，下载并解压对应 arm64 版本。
