如何在VSCode中为Flutter项目配置本地已下载的Gradle文件？

1. 修改项目Gradle wrapper配置 #

找到Flutter项目根目录下的android/gradle/wrapper/gradle-wrapper.properties文件，修改distributionUrl字段：

• 若你已手动下载gradle-8.1.1-all.zip，直接指向本地文件路径（注意格式）：

  # Windows示例
  distributionUrl=file:///D:/gradle-8.1.1-all.zip
  # Linux/macOS示例
  distributionUrl=file:///home/yourname/gradle-8.1.1-all.zip
  

• 若已解压安装Gradle，可将zip放入Gradle默认缓存目录：
  1. 先执行一次flutter run，待出现下载提示后停止，此时会生成缓存目录（路径通常为~/.gradle/wrapper/dists/gradle-8.1.1-all/[随机字符串]/）
  2. 将手动下载的zip放入该目录，重新执行flutter run

2. 全局禁用Gradle自动下载 #

在用户根目录（Windows为C:\Users\你的用户名，Linux/macOS为~/）创建或修改.gradle/gradle.properties文件，添加：

org.gradle.wrapper.userDownload=false

这会强制Gradle wrapper使用本地已有文件，不再触发自动下载。

3. 验证环境变量与Flutter识别 #

• 确认GRADLE_HOME已指向本地Gradle安装目录（如D:\gradle-8.1.1），且PATH中添加了%GRADLE_HOME%\bin（Windows）或$GRADLE_HOME/bin（Linux/macOS）
• 执行flutter doctor -v，检查输出中Gradle版本是否显示为8.1.1，确认Flutter已识别本地Gradle

4. 清除缓存并重新构建 #

进入项目根目录，依次执行以下命令：

flutter clean
flutter pub get
flutter run

5. 无Android Studio的额外配置 #

因未安装Android Studio，需确保Android SDK配置正确：

• 确认ANDROID_HOME环境变量指向你的Android SDK目录
• PATH中添加%ANDROID_HOME%\platform-tools和%ANDROID_HOME%\tools（Windows）
• 执行flutter doctor --android-licenses，按提示接受所有Android SDK许可证

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