【Android开发】创建第一个AndroidStudio项目-附踩坑记录！

前言：

新建安卓项目时，很多人还没开始写代码，就先被Gradle打败了——它要联网下载一堆依赖，国内访问国外服务器慢得要命，经常一等就是半小时起步。这种“开局劝退”体验让很多新手直接关掉了Android Studio。其实只要换个国内镜像源，就能把下载时间从一小时缩短到几分钟。这篇文章就教你如何快速配置Gradle网络环境，让你真正开始写代码，而不是对着进度条发呆。

准备步骤：修改Gradle路径（可选）❗

原始的路径在C:\users\用户名\.gradle目录下，需要将.gradle目录移动到其他盘符目录，然后在环境变量GRADLE_USER_HOME中修改路径，我是放在了D盘。

影响的是以后项目新建时下载Gradle时的存放路径。

疑问解答区：

1、每次一新建Android项目都会下载一个Gradle到本地吗？
答：不是，只要distributionUrl的Gradle版本和源地址相同就会复用同一个Gradle。例如：
distributionUrl=https\://mirrors.aliyun.com/gradle/distributions/v8.9.0/gradle-8.9-bin.zip

技巧：

当你一进入项目时就点击左下角的构建选项然后暂停，再进行下面的操作：

✅ 一、配置 Gradle 下载源（加速构建）

1. 修改gradle-wrapper.properties

路径：项目根目录/gradle/wrapper/gradle-wrapper.properties

将默认的 Gradle 下载地址：

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

例如：替换为阿里云镜像（或其他国内镜像）：

distributionUrl=https\://mirrors.aliyun.com/gradle/distributions/v8.9.0/gradle-8.9-bin.zip

✅ 建议使用与项目兼容的版本（如 8.0 ~ 8.13）。可查看 阿里云 Gradle 镜像 获取最新列表。

2. 修改仓库源（settings.gradle或build.gradle）

⚠️Android Studio 2022+ 推荐在settings.gradle中统一配置

编辑settings.gradle（项目根目录）：

pluginManagement{repositories{// 阿里云镜像（推荐）maven{url'https://maven.aliyun.com/repository/public'}maven{url'https://maven.aliyun.com/repository/google'}maven{url'https://maven.aliyun.com/repository/central'}maven{url'https://maven.aliyun.com/repository/grandle-plugin'}google()mavenCentral()}}dependencyResolutionManagement{repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)repositories{// 阿里云镜像（推荐）maven{url'https://maven.aliyun.com/repository/public'}maven{url'https://maven.aliyun.com/repository/google'}maven{url'https://maven.aliyun.com/repository/central'}maven{url'https://maven.aliyun.com/repository/grandle-plugin'}google()mavenCentral()}}rootProject.name="TestApp"include':app'

✅ 二、配置 Android SDK 镜像源（用于下载 SDK、模拟器等）

方法 1：通过 Android Studio 图形界面设置

1. 打开Settings（Windows:File > Settings；macOS:Android Studio > Preferences）
2. 导航到：
   Appearance & Behavior > System Settings > Android SDK
3. 切换到SDK Update Sites标签页
4. 点击+ Add，添加一个新镜像站点，例如：

✅ 可保留原始 Google 源，但建议优先使用国内镜像。

✅ 三、其他建议

1. 关闭首次启动自动更新（避免卡住）
   在idea.properties（位于 Android Studio 安装目录/bin/下）添加：

   disable.android.first.run=true

2. 手动下载 SDK（如仍失败）

   • 从 清华镜像站 下载commandlinetools或system-images
   • 解压到Android/Sdk/对应目录

3. 清理缓存（若配置后仍失败）

   ./gradlew cleanBuildCache# 或在 Android Studio 中：File > Invalidate Caches / Restart

✅ 总结：首次新建项目必改项

完成以上配置后，新建项目应能正常同步、下载依赖和 SDK，大幅提升开发体验 🚀。

附录：