Mac系统Zsh终端无法识别flutter命令的解决方法咨询

优先排查配置失效问题（无需重装） #

绝大多数之前能正常使用、突然报错的情况，都是zsh配置未正确加载/路径配置错误导致的，按以下步骤排查：

• 确认配置文件位置正确
  Zsh启动时默认加载用户目录下的.zshrc文件，如果你之前把Flutter路径写到了.bash_profile、.bashrc等bash专属配置文件里，zsh不会自动读取。
  终端执行以下命令检查.zshrc里是否有Flutter相关配置：

  cat ~/.zshrc | grep flutter
  

  如果没有任何输出，说明之前的路径配到了错误的文件里。
• 正确配置环境变量
  1. 先定位你本地Flutter SDK的实际存放位置，找到flutter/bin目录的绝对路径（比如SDK存放在/Users/你的用户名/development/flutter，那bin目录路径就是/Users/你的用户名/development/flutter/bin，可以先通过访达找到flutter文件夹，右键选「显示简介」复制完整路径）
  2. 执行命令打开zsh配置文件：

     vim ~/.zshrc
     

  3. 在文件末尾追加一行配置，替换成你自己的bin目录绝对路径：

     export PATH="$PATH:替换成你自己的flutter/bin绝对路径"
     

     注意：路径里不要加多余空格，不要写相对路径，必须是完整绝对路径
  4. 按esc输入:wq保存退出vim后，执行以下命令让配置立即生效：

     source ~/.zshrc
     

  5. 执行flutter --version验证，如果正常输出版本号、渠道信息，说明修复完成。
• 常见配置踩坑点
  • 路径拼写错误：配置完可以先执行cd 你写的flutter/bin路径，如果cd报错找不到目录，说明路径本身写错了，检查文件夹名、是否有多余字符
  • 配置完没有执行source命令，直接在当前终端执行flutter会找不到，要么执行source要么新开一个终端窗口再试
  • Flutter文件夹被移动/删除：比如之前把SDK放在下载目录，被系统或者清理工具删掉了，自然找不到命令

以上方法无效时，彻底重装Flutter流程 #

如果确认配置没问题，还是识别不到命令，可以彻底清理旧文件后重装：

• 清理旧文件
  1. 如果终端还能识别到flutter残留路径，执行which flutter拿到路径后，删除上一级的整个flutter根目录即可，比如输出是/Users/xxx/development/flutter/bin/flutter，就执行：

     rm -rf /Users/xxx/development/flutter
     

  2. 打开~/.zshrc、~/.bash_profile、~/.bashrc几个配置文件，删除所有带flutter关键词的PATH配置行，执行source ~/.zshrc生效
  3. 可选：如果要清理全局pub缓存，执行rm -rf ~/.pub-cache即可
• 重新安装
  1. 下载对应你Mac芯片（Apple Silicon/Intel）的Flutter稳定版SDK压缩包
  2. 解压到固定的开发工具存放目录（比如用户目录下新建development文件夹存放，不要放下载目录、桌面这种容易被误删的位置，也不要放需要root权限的系统目录）
  3. 按照前面的配置步骤把flutter/bin路径加到.zshrc，source生效后执行flutter doctor，按提示安装缺失的依赖（比如Xcode命令行工具、Android SDK等）即可正常使用。

内容的提问来源于stack exchange，提问作者Chri