You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Mac端Flutter安装失败求助:提示‘flutter not found’及版本异常

Flutter安装报错(Mac)

Flutter (Channel unknown, 0.0.0-unknown, on macOS 13.2 22D49 darwin-x64, locale en-US)
! Flutter version 0.0.0-unknown on channel unknown at /Users/macbook/Development/flutter
当前处于未知通道,请执行flutter channel切换至官方通道。若无法解决,请按照https://flutter.dev/docs/get-started/install的指引重新安装Flutter。
无法解析当前版本,可能是由于本地修改导致,请按照上述链接指引重新安装Flutter。
! 警告:路径中的flutter指向/Users/macbook/development/flutter/bin/flutter,不在当前Flutter SDK目录/Users/macbook/Development/flutter内。建议将/Users/macbook/Development/flutter/bin添加至路径前端。
! 警告:路径中的dart指向/Users/macbook/development/flutter/bin/dart,不在当前Flutter SDK目录/Users/macbook/Development/flutter内。建议将/Users/macbook/Development/flutter/bin添加至路径前端。
! 未知上游仓库,请按照上述链接指引重新安装Flutter。

解决步骤

1. 修正环境变量路径

系统检测到flutter和dart命令指向的路径与当前SDK目录不匹配,需将正确路径优先加入环境变量:

  • 打开终端,编辑shell配置文件(zsh用户用~/.zshrc,bash用户用~/.bash_profile):
    open -e ~/.zshrc
    
  • 添加以下配置(替换为你的Flutter SDK实际路径):
    export PATH="/Users/macbook/Development/flutter/bin:$PATH"
    
  • 保存文件后,刷新环境变量:
    source ~/.zshrc
    
  • 验证路径是否生效:
    which flutter
    which dart
    
    确认输出为/Users/macbook/Development/flutter/bin/flutter和/Users/macbook/Development/flutter/bin/dart

2. 修复Flutter通道与仓库配置

当前Flutter处于未知通道且上游仓库无效,执行以下操作:

  • 切换至官方稳定通道:
    flutter channel stable
    
  • 更新Flutter SDK:
    flutter upgrade
    
  • 若更新失败,手动重置仓库配置:
    cd /Users/macbook/Development/flutter
    git remote set-url origin https://github.com/flutter/flutter.git
    git fetch
    git checkout stable
    

3. 验证修复结果

执行命令检查Flutter状态:

flutter doctor

若问题仍存在,彻底重新安装Flutter:

  • 删除现有Flutter目录:
    rm -rf /Users/macbook/Development/flutter
    
  • 克隆官方稳定版本:
    git clone https://github.com/flutter/flutter.git -b stable /Users/macbook/Development/flutter
    
  • 重新配置环境变量后执行flutter doctor

内容的提问来源于stack exchange,提问作者Gbenga Otunla

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.02 18:56:15