MacOS Big Sur下如何修复Flutter Doctor的dart路径警告？

问题原因 #

警告是因为系统环境变量PATH中，brew安装的Dart路径优先级高于Flutter SDK自带的Dart路径，导致Flutter检测到非配套的Dart版本，可能引发版本兼容问题。

解决步骤 #

临时生效（仅当前终端会话）

• 在终端执行以下命令，将Flutter的bin目录放到PATH最前端：

  export PATH="/Users/puneet/development/flutter/bin:$PATH"
  

• 执行完成后，运行flutter doctor检查警告是否消失。

永久生效（所有终端会话）

MacOS Big Sur默认使用zsh终端，操作如下：

1. 打开zsh配置文件：

   open ~/.zshrc
   

2. 在文件末尾添加一行配置：

   export PATH="/Users/puneet/development/flutter/bin:$PATH"
   

3. 保存并关闭文件后，执行命令让配置立即生效：

   source ~/.zshrc
   

4. 重启终端，再次运行flutter doctor确认警告已消除。

如果你的终端使用bash，将上述步骤中的~/.zshrc替换为~/.bash_profile或~/.bashrc即可。

补充说明 #

调整路径优先级后，系统会优先调用Flutter SDK内置的Dart工具，确保和当前Flutter 3.7.0版本的兼容性，同时让Android Studio能正确识别配套的Flutter与Dart环境，正常运行Flutter项目。

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