Mac OS执行flutter upgrade遇未知源与FLUTTER_GIT_URL冲突错误求助

DevOps 小满

2026-6-14

解决Flutter Upgrade时"unknown source"与FLUTTER_GIT_URL循环冲突问题

先检查并重置Flutter SDK的Git远程源：
切换到你的Flutter SDK安装目录，执行以下命令查看当前远程配置：
```
cd /path/to/flutter-sdk
git remote -v
```
如果输出里的origin地址不是官方仓库地址，执行命令重置：
```
git remote set-url origin https://github.com/flutter/flutter.git
```
统一FLUTTER_GIT_URL环境变量：
在Mac上打开对应的Shell配置文件（zsh用户编辑~/.zshrc，bash用户编辑~/.bash_profile），添加或修改以下内容：
```
export FLUTTER_GIT_URL="https://github.com/flutter/flutter.git"
```
执行命令让配置立即生效：
```
source ~/.zshrc  # 对应你实际使用的配置文件
```
清理缓存并重新执行升级：
先清理Flutter缓存：
```
flutter clean
```
运行flutter doctor确认环境配置正常，最后执行升级命令：
```
flutter upgrade
```
若上述步骤无效，尝试重新克隆官方SDK：
```
git clone https://github.com/flutter/flutter.git
```
更新系统PATH环境变量，指向新克隆的SDK目录，再重复上述升级步骤。