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

升级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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.01 21:54:02