Mac环境下Flutter工具构建失败问题求助

报错信息 #

Building flutter tool...
Failed to start the Dart CLI isolate. Could not resolve DartDev snapshot or kernel.
(null).
Error: Unable to 'pub upgrade' flutter tool. Retrying in five seconds... (9 tries left)
Failed to start the Dart CLI isolate. Could not resolve DartDev snapshot or kernel.
(null).
Error: Unable to 'pub upgrade' flutter tool. Retrying in five seconds... (8 tries left)
Failed to start the Dart CLI isolate. Could not resolve DartDev snapshot or kernel.

解决步骤 #

• 清理Flutter及Pub缓存
  先执行官方缓存清理命令：

  flutter clean
  

  若无效，手动删除缓存目录：

  rm -rf ~/Library/Caches/flutter
  rm -rf ~/.pub-cache
  

• 重置Flutter仓库（Git克隆版适用）
  进入你的Flutter安装目录，执行以下命令重置到稳定分支：

  cd /path/to/flutter
  git clean -xfd
  git fetch
  git reset --hard stable
  

• 验证Flutter环境变量配置
  检查Flutter的bin目录是否在系统PATH中：

  echo $PATH
  

  若未找到Flutter路径，编辑Shell配置文件（zsh用户为~/.zshrc，bash用户为~/.bash_profile），添加：

  export PATH="$PATH:/path/to/flutter/bin"
  

  保存后刷新配置：

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

• 手动升级Flutter工具依赖
  进入Flutter工具包目录，手动执行pub升级：

  cd /path/to/flutter/packages/flutter_tools
  dart pub upgrade
  

• 检查权限与磁盘空间
  确保当前用户对Flutter安装目录有读写权限，同时检查磁盘剩余空间：

  df -h
  

  若权限不足，执行：

  sudo chown -R $USER /path/to/flutter
  

• 重新下载Flutter SDK
  若以上方法均无效，直接下载官方稳定版Flutter SDK替换原有目录，避免克隆过程中出现的文件损坏问题。

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