macOS执行flutter doctor提示zsh: command not found: flutter问题排查

错误点总结 #

• 配置文件选错：当前使用的是zsh终端，~/.bash_profile是bash终端的专属配置文件，zsh默认不会读取该文件，所以你的路径配置根本没生效。
• PATH路径不完整：Flutter的可执行文件flutter存放在版本目录的bin子文件夹中，你只配置到了版本根目录/Users/motogod19/fvm/versions/3.12.0，系统找不到可执行文件。
• PATH设置方式错误：直接用export PATH=/xxx会覆盖系统原有PATH，可能导致其他系统命令也无法使用，正确做法是在原有PATH后追加新路径。

正确操作步骤 #

1. 打开zsh的配置文件：

   open -e ~/.zshrc
   

2. 在文件末尾添加正确的PATH配置：

   export PATH="$PATH:/Users/motogod19/fvm/versions/3.12.0/bin"
   

3. 让配置立即生效：

   source ~/.zshrc
   

4. 再次执行验证命令：

   flutter doctor
   

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