创建Flutter新项目时出现下载失败错误，寻求解决方案

安全阿岳

2026-7-22

Flutter 创建新项目失败的解决办法

问题描述

我尝试创建一个新的Flutter项目时遇到了如下错误：
输入图片描述

网络连接正常，报错中的链接在浏览器可直接下载，但创建项目时就是失败。用Android Studio创建也出现同样错误，多次换网络、更新Flutter版本、执行flutter clean都没效果，怀疑是Flutter缓存问题，该怎么解决？

手动替换缓存依赖
找到报错里的资源链接，手动下载对应文件，放到Flutter的pub缓存目录：
- Windows路径：C:\Users\<你的用户名>\.pub-cache\hosted\pub.dartlang.org\
- macOS/Linux路径：~/.pub-cache/hosted/pub.dartlang.org/
  下载后解压到对应包名的文件夹，确保文件结构和正常下载的一致。
清理异常代理设置
执行命令查看当前代理配置：
```
flutter config --show
```
如果存在异常的HTTP/HTTPS代理，执行以下命令清除：
```
flutter config --clear-http-proxy
flutter config --clear-https-proxy
```
修复pub缓存
执行命令修复损坏的缓存文件：
```
flutter pub cache repair
```
该命令会重新校验并下载所有缓存的依赖包。
创建空项目手动加依赖
先创建一个极简空项目：
```
flutter create --empty test_project
```
进入项目目录后，手动在pubspec.yaml中添加所需依赖，再执行flutter pub get，测试是否能正常拉取资源。