Mac端VSCode+Flutter项目Android模拟器构建失败：GradleWrapperMain类未找到

嘿，这个报错我之前在Mac上折腾Flutter环境的时候也碰到过！核心原因就是Gradle Wrapper的文件损坏或者缺失——毕竟你iOS能正常跑，说明Flutter本身的环境没啥问题，问题就出在Android端的Gradle配置上。下面给你几个亲测有效的解决步骤：

• 第一步：清理现有损坏的Gradle文件
  先进入你的项目目录，找到android/gradle/wrapper文件夹，删掉里面的gradle-wrapper.jar文件；另外还可以删掉android/.gradle这个缓存目录（放心，删掉之后会重新生成，不会影响项目代码）。

• 第二步：重新生成Gradle Wrapper
  打开终端，cd到项目的android目录下，运行命令：

  gradle wrapper
  

  如果你的系统里没单独装Gradle，也可以先用Flutter的清理命令重置一下：

  flutter clean
  flutter pub get
  

  之后再回到android目录尝试生成wrapper，或者直接打开Android Studio导入项目的android模块——AS会自动检测并下载缺失的Gradle文件，这个方法有时候更省心。

• 第三步：检查配置文件的有效性
  打开android/gradle/wrapper/gradle-wrapper.properties，确认里面的distributionUrl是正确的，比如类似这样的格式：

  distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-all.zip
  

  如果URL不对或者网络下载不了，也会导致找不到主类的问题，确保你的网络能正常访问这个地址。

做完这些步骤之后，再回到VSCode里尝试运行Android模拟器，应该就能正常启动了。如果还是有问题，可以试试重启VSCode或者Android模拟器，有时候缓存残留也会搞事情～

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