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

新手使用Android Studio创建首个项目遇报错如何解决

Android Studio 首次创建项目报错修复方法

按以下步骤顺序操作,可解决90%以上Android Studio首次创建项目的报错问题:

  • 校验核心SDK组件安装状态
    依次打开顶部菜单栏 File > Settings > Appearance & Behavior > System Settings > Android SDK,在SDK Platforms栏确认当前项目所选API等级的SDK完整安装;在SDK Tools栏确认Android SDK Build-Tools、Android SDK Platform-Tools两项核心组件已安装,缺失组件勾选后点击Apply等待安装完成,重启Android Studio后重试。
  • 替换国内镜像源解决依赖拉取失败
    首次创建项目默认从境外源拉取Gradle插件、项目依赖,网络连通性差是最高发的报错原因。找到项目根目录下的settings.gradle文件(Android Studio新版本配置路径,老版本对应根目录下build.gradle文件),将仓库配置段替换为国内公共镜像源配置,保存后点击顶部工具栏的Gradle同步按钮(大象图标)重新同步即可。
    对应配置代码参考:
    pluginManagement {
        repositories {
            maven { url 'https://maven.aliyun.com/repository/google' }
            maven { url 'https://maven.aliyun.com/repository/public' }
            maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
            google()
            mavenCentral()
            gradlePluginPortal()
        }
    }
    dependencyResolutionManagement {
        repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
        repositories {
            maven { url 'https://maven.aliyun.com/repository/google' }
            maven { url 'https://maven.aliyun.com/repository/public' }
            google()
            mavenCentral()
        }
    }
    
  • 校验Gradle JDK版本匹配
    依次打开File > Settings > Build, Execution, Deployment > Build Tools > Gradle,找到Gradle JDK配置项,下拉选择Android Studio内置的对应版本JDK即可(2022年之后发布的Android Studio版本统一选择JDK 17,不要自行配置版本不匹配的独立安装JDK),确认后重新触发同步。
  • 清理无效代理配置
    如果之前配置过网络代理,依次打开File > Settings > Appearance & Behavior > System Settings > HTTP Proxy,选择No proxy选项保存,清除无效代理配置后再重试同步。

注意:首次项目同步过程不要手动中断进程,网络正常情况下3-5分钟即可完成同步,同步完成后项目无报红即可正常运行调试。

内容的提问来源于stack exchange,提问作者Momodu Sesay

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.30 11:39:19