Flutter搭建及首个程序运行故障求助：编译失败与网络异常

一、优先修复网络连接问题 #

1. 调整代理与网络环境 #

• 关闭全局代理或VPN，确认当前网络可正常访问github和cocoapods.org
• 若必须使用代理，配置Flutter专属代理：

  flutter config --set http-proxy http://你的代理地址:端口
  flutter config --set https-proxy http://你的代理地址:端口
  

  取消代理执行：

  flutter config --unset http-proxy
  flutter config --unset https-proxy
  

2. 排查本地拦截机制 #

• 用浏览器直接访问https://github.com和https://cocoapods.org，确认页面能正常加载，无SSL握手错误
• 临时关闭本地防火墙、杀毒软件，重试Flutter相关命令，排查是否有请求被拦截

二、修复flutter build debug失败问题 #

• 清理项目缓存并重新拉取依赖：

  flutter clean
  flutter pub get
  

• 验证Android SDK构建工具：
  打开Android Studio，进入File > Settings > Appearance & Behavior > System Settings > Android SDK，确认Android SDK Build-Tools 34.0.0已安装，缺失则点击安装
• 重新生成Android项目配置文件：

  flutter create --platforms android .
  

三、修复大版本升级异常 #

• 手动下载对应稳定版Flutter压缩包，解压后替换本地Flutter安装目录
• 替换后执行以下命令完成初始化：

  flutter doctor
  flutter pub upgrade --major-versions
  

• 若仍有异常，删除Flutter安装目录下的bin/cache文件夹，再重新执行flutter doctor

四、验证修复效果 #

依次执行以下命令确认问题解决：

flutter doctor -v
flutter build debug
flutter upgrade

内容的提问来源于stack exchange，提问作者xRobot