升级Flutter后Android Studio创建Flutter项目卡住,flutter doctor无异常
问题排查方向
- Flutter镜像源配置异常:升级Flutter版本后原有镜像源失效,或未配置国内可用镜像源,创建项目阶段需要拉取依赖包时因网络不通长时间阻塞。
- IDE插件版本不兼容:Android Studio中安装的Flutter、Dart插件版本与升级后的Flutter SDK版本不适配,导致项目创建流程无法正常推进。
- 项目存储路径不符合要求:选择的保存路径包含中文、空格、特殊字符,或当前用户无对应路径的读写权限,导致项目文件写入失败卡住。
- 本地缓存损坏:Gradle或Flutter本地缓存存在损坏文件,创建项目初始化环境时触发阻塞。
- Flutter SDK组件缺失:升级Flutter过程中出现异常,部分SDK组件未完整安装,创建项目时无法调用对应能力。
解决方案
1. 配置国内Flutter镜像源
在Windows系统环境变量中新增以下两个变量:
PUB_HOSTED_URL=https://pub.flutter-io.cn FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
配置完成后重启Android Studio再尝试创建项目。
2. 更新适配版本的IDE插件
打开Android Studio插件管理界面,将Flutter、Dart插件更新到与当前Flutter SDK适配的最新版本,重启IDE后重试。如果更新后仍存在兼容问题,可卸载原有插件后重新安装匹配版本。
3. 调整项目存储路径
- 选择无中文、无空格、无特殊字符的目录作为项目保存路径
- 确认当前系统用户对目标目录拥有读写权限
4. 清理并重建本地缓存
执行以下命令清理Flutter缓存并重新预加载SDK组件:
flutter clean flutter precache
同时可进入本地Gradle缓存默认目录C:\Users\当前用户名\.gradle\caches,删除旧的缓存文件,项目创建时会自动下载匹配的Gradle版本。
5. 命令行创建项目绕过IDE阻塞
若以上方案均无效,可直接在终端执行项目创建命令:flutter create <你的项目名称>
创建完成后再通过Android Studio打开项目即可正常使用。
内容的提问来源于stack exchange,提问作者Otis
相关产品推荐
相关产品推荐

