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

新建Gradle项目同步总是失败,求根源及永久解决办法

彻底解决新建项目Gradle构建解析错误的方法
  • 设置Android Studio默认Gradle/AGP版本
    打开File > New Project Settings > New Project Structure(或直接在Settings搜索Gradle),将默认的Android Gradle Plugin(AGP)和Gradle版本设置为官方兼容的稳定组合(比如AGP 8.0对应Gradle 8.0,可根据你常用的SDK版本选择匹配的组合),保存后新建项目会自动使用该版本,无需每次手动修改。

  • 清理本地Gradle缓存
    找到本地Gradle缓存目录:Windows为C:\Users\<你的用户名>\.gradle\caches,Mac/Linux为~/.gradle/caches,删除整个caches文件夹后重新同步项目,排除缓存损坏导致的解析异常。

  • 检查代理与环境变量
    若使用代理,确认Gradle配置能正常访问代理(可在gradle.properties中配置systemProp.http.proxyHost等参数);或者临时关闭代理测试,很多依赖下载失败引发的解析错误都和代理有关。同时检查GRADLE_USER_HOME环境变量是否正确指向Gradle缓存目录,避免路径异常。

  • 修复自定义项目模板
    如果你修改过Android Studio的项目模板,找到模板中的项目级和模块级build.gradle文件,将里面的AGP、Gradle版本替换为稳定兼容值,确保新建项目时直接套用正确配置。

  • 更新Android Studio到最新稳定版
    旧版本AS自带的项目模板可能存在版本兼容问题,升级到最新稳定版后,默认模板的Gradle/AGP版本会是当前生态的稳定组合,从根源减少版本不匹配的问题。

内容的提问来源于stack exchange,提问作者Shivanshu Raj

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.07.18 05:22:07