macOS安装Flutter SDK遇Flutter/Dart二进制文件路径问题求解决

提示信息含义 #

! The flutter binary is not on your path. Consider adding /Users/gauravkumar/Documents/development/flutter/bin to your path.
! The dart binary is not on your path. Consider adding /Users/gauravkumar/Documents/development/flutter/bin to your path.

这两句提示说明系统无法全局调用flutter和dart命令，因为它们的可执行文件所在的flutter/bin目录未被添加到系统环境变量PATH中。终端和VS Code需要通过PATH定位到这些工具的位置，才能在任意目录执行相关命令。

最后那句! Doctor found issues in 3 categories表示Flutter检测工具共发现3类问题，路径配置问题是其中之一，解决完路径问题后可重新运行flutter doctor查看剩余问题。

解决步骤 #

macOS/Linux系统

• 打开终端，编辑对应shell的配置文件：
  • 若使用zsh（macOS默认），编辑~/.zshrc；若使用bash，编辑~/.bash_profile或~/.bashrc
• 在文件末尾添加命令：

  export PATH="$PATH:/Users/gauravkumar/Documents/development/flutter/bin"
  

• 保存文件后，执行以下命令让配置立即生效：

  # zsh用户
  source ~/.zshrc
  # bash用户
  source ~/.bash_profile
  

• 验证：终端输入flutter --version和dart --version，能正常显示版本信息即配置成功

Windows系统

• 打开「控制面板」→「系统」→「高级系统设置」，点击「环境变量」
• 在「系统变量」列表中找到Path，点击「编辑」
• 点击「新建」，输入Flutter的bin目录路径（示例：C:\Users\gauravkumar\Documents\development\flutter\bin）
• 依次点击「确定」保存所有设置
• 重启终端和VS Code，输入flutter --version验证配置是否生效

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