Android Studio 安装配置教程Windows(详细版)

前言

转载声明

本文是对 CSDN 博主 qq_38436214 文章的整理与实践记录。

原文链接：https://blog.csdn.net/qq_38436214/article/details/105073213

在 Android 开发领域，Android Studio (AS) 无疑是 Google 官方主推且不可或缺的核心生产力工具。随着版本的不断迭代，如今的 Android Studio 已经变得更加智能和开箱即用，通常直接下载就是免费版本，完全够用。

对于许多初学者或从老版本迁移过来的开发者来说，开发环境的配置往往是“万事开头难”的第一步。例如，早期的 AS 需要开发者手动配置 Java JDK 的环境变量才能正常编译项目，而现在的新版本（如本文使用的 2025.1.1 版本）已经内置了 JDK（最低要求 JDK 17），极大简化了初始配置的繁琐度。

我需要配置 JDK 环境变量吗？

仅做 Android 开发：通常不需要，直接使用 AS 内置的 JDK 即可。
兼顾常规 Java 开发：建议配置系统的 JDK 环境变量（注意 JDK 11/17 与 JDK 8 的配置略有不同，前者可能需要手动生成 jre 目录）。

本文将从下载、安装、项目创建（区分全新的 Compose 模板与常规的 Views 模板），到核心开发组件（如 ViewBinding）的使用，以及 Gradle/SDK/JDK 环境版本的排查与切换，提供一份保姆级的图文避坑指南。

一、Android Studio 下载

Android Studio下载地址-谷歌中国，最新版本目前是 Android Studio Narwhal | 2025.1.1 Patch 1 ，你可以到官网上去找之前的版本，手上有工作项目的不要去轻易尝试，说不定你就编译失败了，失败了也不要担心，解决就可以了。

在这里插入图片描述

点击 Download Android Studio 进行下载，会出现一个弹窗告诉这个版本的一些信息。

在这里插入图片描述

不用管他，直接滑动到最后。

在这里插入图片描述

勾选上，点击按钮下载即可，下载好之后会在本地有一个exe安装程序，下面来安装。

二、Android Studio 安装

双击运行安装。

在这里插入图片描述

点击 Next 下一步。

在这里插入图片描述

点击 Next 下一步。

在这里插入图片描述

默认会给你装到C盘，这里我修改到了D盘( PS: 这里一定要改路径，否则随着你开发过程中，你的C盘空间会越来越小，这里我放的是D盘，只要不装在系统盘里，其他盘随意，不过也要有一定空间才行。 ),点击 Next 下一步。

在这里插入图片描述

点击 Next 下一步( PS：这里没有其他骚操作，不要乱来 )

在这里插入图片描述

等安装完成。

在这里插入图片描述

点击 Next 下一步。

在这里插入图片描述

点击 Finish 进行第一次运行了,如果你不是第一安装了，那么就是覆盖安装，也是一步到位，没啥好讲的。现在我们运行一下：

在这里插入图片描述

如果你选择上面那个就会在你电脑安装默认的配置，这里不导入配置，直接 OK 即可，然后你就会看到AS的启动图片：

在这里插入图片描述

不得不说比之前的要好看一些，然后会弹出。

在这里插入图片描述

就是让发送使用的信息给谷歌，发个锤子，点击 “ Don’t send ”。

在这里插入图片描述

然后我们进入了欢迎页面，这个图片是告诉你，Android能做的事情有手机、穿戴设备、TV、车载，还有智能设备等，点击 Next 。

在这里插入图片描述

这个地方是说你没有SDK，让你设置代码，这里不设置，点击 Cancel 。

在这里插入图片描述

Android Studio 默认会把你的SDK下载放在C盘，到时候你的C盘就炸了，谷歌太坏了，很多新手都会直接下一步，这里你需要选择 Custom ，切记切记，然后点击 Next 下一步。

在这里插入图片描述

之前我们选择自定义SDK的路径，在这里就需要自己设置路径了，如果你之前有下载过Sdk，而这次又将Sdk的目录选择为之前的目录，那么就会出现一些组件提示(installed)，我选择在D盘下，改好之后就点击 Next 。

在这里插入图片描述

这里是给Android模拟器进行内存设置，推荐4G，这里直接 Next 。

在这里插入图片描述

这里是安装Android虚拟器管理驱动，点击 Next 即可。
在这里插入图片描述

接下来就是下载需要的一些SDK了，点击 Next 。

在这里插入图片描述

在下载前，需要你接受一些协议，你不会真去看这些协议的，除非你是想摸鱼，左侧的三项，每一项选中之后点击 Accpet ，接受协议，三项都通过之后，你会看到 Finish 按钮亮起，点击 Finish 。

在这里插入图片描述

这一步比较考验网络，通俗一点就是看命了，命硬的一步到位，命苦的喝杯咖啡以毒攻毒。如果你的网络不支持很有可能导致失败，那么你可能需要更换网络环境再进行重新安装尝试，这一点就很烦了，很多人都会遇到这个问题。运气好的网速好的情况下也就几分钟，不好几个小时都是有可能的。很明显，我的这个网速就不这么样，这个时候你就可以泡一杯咖啡，说到咖啡你有没有想到Java的图标呢？

在这里插入图片描述

终于组件下载完毕了，这里你看到有一项安装失败的，先不管他，点击 Finish 。现在我们已经安装好了Android Studio，下面就可以开始使用了。

三、Android Studio 使用

在这里插入图片描述

这里我们点击 New Project ，创建一个新的项目。

在这里插入图片描述

这里选中的是 Empty Activity ，在新版本的 Android Studio 中 Empty Activity 模板默认的就是 Compose 模板，如果你没有接触过，可以去了解一下，如果你希望创建Java或者Kotlin语言模板的项目，那么就选择 Empty Views Activity ，点击 Next ，这里我选择的是 Empty Activity 模板， Empty Views Activity 模板后面会提到。

3.1 创建默认项目（Compose）

在这里插入图片描述

这里会默认创建一个 Jetpack Compose 项目，默认语言就是Kotlin，Compose和之前的XML布局的方式还是有很大区别，然后我们改了项目的名称，改了项目存放的路径，默认在C盘，我改到了D盘，而这里最低兼容SDK为API 24，对应Android7.0，这里有一个需要注意的地方那就是， Build configuration language ，在之前的AS中已经可以使用Kotlin作为Gradle的语言了，只不过没有主推，而现在的这个默认选项的意思就是使用Kotlin作为Gradle的构建语言了，之前一直都是使用Groovy进行构建的，点击下拉框可以看到，如下图所示。

在这里插入图片描述

那么选择什么类型呢？我们分情况来看，分为如下三种情况，就以开发者自身来看。

小白开发者：建议你选择 Groovy DSL ，这样Gradle的语言就和之前你是用的AS一样，同时，如果你遇到相关的问题去网上搜索大部分资料也都是基于Groovy语言的，Kotlin语言的比较少，毕竟推出的时间不长。更何况如果你还有一些老项目的话，更加要选择Groovy，听人劝，吃饱饭。
专一开发者：这个不是说感情专一，而是对于AS编辑器只用一个版本，比如现在还有使用Android Studio3.5、4.1的，但是实际工作中需要他升级AS的版本，那么到这个版本时，如果对自己有信心并且有时间解决相关的问题，那么可以选择Kotlin，也可以选择Groovy。
老油条开发者：爱咋咋地。

如果你选择Kotlin DSL，点击 Finish 。

在这里插入图片描述

直接进入项目页面，并且你会看到底部在下载一些SDK文件，这个过程也需要你的网络条件比较好，否则轻则速度很慢，重则直接连接超时，你会看到一些报错的字样。

在这里插入图片描述

我这里比较顺利，如果不顺利的话，可能就是不断的提示你超时或者连接失败，如下图所示：

在这里插入图片描述

第一次创建项目，下载的内容会比较多，这里以gradle为主要内容，其他内容就是支持项目编译运行所需要的插件，组件等内容，而这个gradle如果网络不好就会直接停止下载，你可以切换网络环境继续下载，直到你的项目可以正常运行为止。这段话很重要，评论区很多人都会遇到这个问题，问我怎么办，其实就是你当前的网络下载资源受限或者是很慢导致编译时候，这个时候你就手机开个热点，电脑连上然后 Try Again 就行了，另外也和手机卡的网络有关系，三大运营商都可以试试，一个人不可能集齐三个运营商，一堆人就很简单了。

我们还可以通过更换镜像源，因为国内访问Google有时候不稳定，没有条件搭梯子翻墙的话，那就可以使用国内的镜像源，这样我们访问起来就很快了，尤其是项目配置的时候，那么怎么去替换呢？打开项目的 gradle-wrapper.properties ，位置如下图所示：

在这里插入图片描述

注意我标注的地方，实际上我们只需要改一部分，比如我们改成腾讯的源

1	distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.9-bin.zip

就是从

1	services.gradle.org/distributions

改成

1	mirrors.cloud.tencent.com/gradle

改完之后 Sync Now ，等待下载

在这里插入图片描述

完成之后我们可以直接启动运行，你也可以使用快捷键 Shift + F10 ，顺利的话你就运行成功了，否则你可能会出现下面的弹窗提示。

在这里插入图片描述

需要你安装HAXM，这个前面我们就已经是安装失败了，那么点击OK，然后继续下一步。

在这里插入图片描述

到这里为止你会发现还是不行，那么我们就需要检查一下自己的电脑有没有开启 “Intel (VMX) Virtual Technology” (或者叫虚拟化技术) ，这个根据自己的电脑品牌去进行操作，那么换个方式，都需要进入BIOS里面，这里我就不多说了，自行百度解决。

在这里插入图片描述

开启VT之后，再打开AS运行项目，这次就会成功了。

在这里插入图片描述

已经运行到虚拟机上了，到这里创建Compose项目，就完成了。

3.2 创建常规项目

相信会Compose的还是少数，虽然Google官方在推这个组件，但是在国内，用的还是在少数，大部分人不会轻易去使用，尤其是在你不熟悉的时候，但是学习还是可以的，因此我们下面来创建常规的项目，常规的项目就分Java和Kotlin两种语言了，据我所知，目前很多学校里就是用Kotlin作为主要语言的，那么我们就来创建一个Kotlin语言的项目吧。

![image-20260424210130286](https://gitee.com/jdhhka6/pic_bed/raw/master/img/image-20260424210130286.png

File → New → New Project ，会出现一个弹窗。

这里我们选择 Empty Views Activity ，点击 Next 。

这里的项目就和我们之前Android Studio创建项目的方式一样了，语言你可以切换Java，Kotlin，这里就选择Kotlin，点击 Finish 。

这里也会下载一堆插件，同样需要网络比较好的情况，我大概花了31分钟，下载完成之后我们直接运行看看。

很顺利，我们又运行成功了，这是Kotlin的项目，Kotlin项目的开发你需要掌握Kotlin语言，不然很多的特性你都看不懂，学会了就用起来很爽，下面我们来使用ViewBinding，这是Google官方推出的一个Jetpack 组件，下面我将会分别在Kotlin语言和Java语言中使用，至于Compose中是不需要这个组件的，因为Compose项目中没有xml，注意。

3.3 使用ViewBinding

在使用ViewBinding之前，我们先了解它是用来干什么的，一句话概括就是可以让你不用再写 findViewById() ，因为常规的Android项目都是代码和布局XML构成页面，我们在页面上去完成自己的业务需求逻辑，业务功能，而代码中使用XML中的控件，首先要给控件Id，其次要实例化，通过 findViewById() 来完成，这个步骤在XML中控件很多的时候就尤为繁琐，因此Google推出ViewBinding来解决这一问题，如果你想知道ViewBinding是怎么实现的，可以留言，下面我们来讲述怎么使用ViewBinding。

打开app模块的build.gradle，然后添加如下代码：

Groovy版本：

1
2
3

buildFeatures {
    viewBinding true
}

Kotlin版本：

1
2
3

buildFeatures {
    viewBinding = true
}

然后右上角会出现 Sync Now ，点击一下就会下载相应的资源，如上图所示，现在我们就是相当于打开了 ViewBinding 的开关，然后我们使用它，在activity_main.xml中为TextView写一个id。

然后回到MainActivity中使用。

这里的使用也很简单，如果你了解Kotlin语法的话，首先是创建一个binding变量，类型是ActivityMainBinding，这是一个编译时生成的类，它源于你的 activity_main.xml ，就是将你的xml进行驼峰名称再加上Binding后缀，如果你的布局是item_device.xml，那么生成的类就是ItemDeviceBinding，这样你应该好理解了，参考上图的写法即可，下面我们再用一张图来说明Java项目中的ViewBinding的用法。

配置开关和为控件增加Id都是一样的，只是语法上有区别，如上图所示。

3.4 查看Gradle版本、SDK版本、JDK版本

一个项目能否正常编译取决于我们的Gradle、SDK以及JDK，不同版本之间是由不同的配置关系的，这对于你来说是否有些复杂呢？

JDK (Java Development Kit)

代表什么：Java 语言的软件开发工具包。

具体职责：它提供了编译、调试和运行 Java 代码所必需的基础环境。包含了 JRE（Java 运行环境）、Java 虚拟机（JVM）以及核心类库（如 String、List、多线程等最基础的语法组件）。

在 Android 中的角色：虽然现在 Android 主推 Kotlin，但 Kotlin 也是跑在 JVM 上的，底层依然依赖 Java 的生态。JDK 就像是扳手、电焊机和基础物理定律，没有它，你连最基本的代码指令都无法执行。

JDK 只负责 Java 语言本身的编译和运行。它不关心你是用来做网站后台、大数据处理，还是写 Android 应用。

SDK (Software Development Kit)

代表什么：软件开发工具包。在本文语境下，特指 Android SDK。

具体职责：它是 Google 官方提供的，专门用于开发 Android 应用的接口、工具和模拟器。它包含了 Android 特有的核心类（如 Activity、TextView、Toast 等），以及打包工具和调试桥（ADB）。

在 Android 中的角色：如果你只有 JDK，你只能写出能在电脑黑框框里跑的通用 Java 程序。要让程序在手机上跑，并且能调用手机的摄像头、屏幕绘制 UI，就需要使用 Android SDK。它就像是汽车厂商提供的底盘、方向盘和发动机图纸。

Android SDK 只负责提供 Android 手机特有的功能和 API。它不需要关心底层的编译原理是怎样的。

Gradle

代表什么：项目自动化构建工具。

具体职责：在现代开发中，一个项目往往包含成百上千个代码文件，还需要引用外部的第三方库（比如网络请求库 Retrofit、图片加载库 Glide）。如果全靠手动去敲命令编译代码、下载库、打包，会极其繁琐且容易出错。Gradle 就是用来自动化处理这些事情的。

在 Android 中的角色：Gradle 会读取你的配置文件（build.gradle），自动去网络上下载你需要的第三方库，然后调用 JDK 将代码编译成字节码，再调用 Android SDK 的工具将其转换为 Android 能识别的格式，最后把资源文件（图片、XML）一起打包成一个完整的安装包（APK 或 AAB）。它就是掌控全局的装配流水线主管。

Gradle 只负责项目构建与依赖管理。它不仅能构建 Android 项目，也能构建纯 Java 项目、C++ 项目。

不过不用担心，当你可以正常安装Android Studio并且能够正常运行时，你的这三个配置就是可以的，属于默认搭配，你只管写代码就好了。

然而，世事无常，也许有时候项目的开发者不是自己，那么别人的项目你想要运行，有两个选择，第一：配置项目所需要的Gradle和SDK，第二：更改项目的Gradle和SDK满足当前环境。

3.4.1 Gradle版本

Gradle再细分就是Gradle版本和Gradle插件版本，两者之间是有关联的，你可以参考 Android Gradle 插件版本说明，下面我们先看Gradle版本，如下图所示查看：

Gradle插件版本，如下图所示查看：

怎么查看就怎么修改，修改后记得要Sync Now点击一下。

3.4.2 SDK版本

SDK版本就是当前项目所编译的版本，下面我们查看一下当前项目的配置Android版本，如下图所示：

这里 compileSdk 33 表示编译版本为API 33，对应的是Android13.0版本， minSdk 24 表示最低编译版本为API 24，对应Android 7.0版本，换句话来说，你的项目可以在Android7.0到Android13.0这个区间的的Android设备上运行，当然也包括7.0和13.0， targetSdk 33 表示当前SDK版本为API 33，当你的项目低于或者高于这个环境的时候你就需要配置相关的SDK了，在哪里配置呢？顶部导航栏点击 File → Settings... 如下图所示：

这里我们可以看到当前下载Android 13.0的SDK，还能看到其他的Android版本，也可以看到Android版本所对应的API版本，这里我们看到的是简略信息，你可以勾选右下方的 Show Package Details ，就能查看详情信息了，当我们下载其他版本的SDK时，勾选上，要下载的目标版本SDK，此时弹窗右下角底部的 Apply 按钮就可以点击了，点击之后就会下载相关的SDK，然后你就可以切换其他的API版本了。

3.4.3 JDK版本

JDK版本如下图所示：

这里就很简单了，默认的是JDK 17，这里就关系到你的项目能否正常运行，点击下拉框就可以看到这个JDK的版本信息了，或者你添加自己本地的JDK也行。

总结

完成环境搭建并成功运行项目后，开发才刚刚开始。为了巩固本教程涉及的环境配置要点，我们通过 Q&A 的形式进行回顾，这些也是后续排查编译错误的常见思路：

Q1：安装 SDK 时为什么一定要自定义路径？

A： Android Studio 默认会将 SDK 及其相关镜像文件下载到 C 盘。随着项目的增加和 SDK 版本的更新，这些文件会占用巨大的磁盘空间（动辄几十GB）。因此，在初始安装时选择非系统盘（如 D 盘）进行 Custom 安装，是保持系统流畅运行的关键习惯。

Q2：新建项目时，Gradle 构建语言应该选择 Kotlin DSL 还是 Groovy DSL？

A：视你的项目经验和维护需求而定：

新手/维护老项目：推荐选择 Groovy DSL。目前网上绝大多数的教程、解决方案以及历史项目的构建脚本都是基于 Groovy 的，遇到问题更容易查到资料。
追求前沿：如果是一个全新的项目，且团队/个人对 Kotlin 比较熟悉，可以选择 Kotlin DSL，它是 Google 推荐的未来趋势。

Q3：项目一直在 Sync 且报错，大概率是什么原因？

A：这是新手最常遇到的问题。90% 的概率是因为网络环境受限，导致 Gradle 本体或相关依赖库下载超时。

解决方案：建议配置国内镜像源（如将 services.gradle.org 替换为腾讯或阿里云的镜像源），或者尝试切换手机热点（尝试不同运营商的网络）后点击 Try Again。

Q4：为什么有了 ViewBinding，我们就不需要写 findViewById 了？

A： ViewBinding 是一种编译时技术。只要开启了此功能，系统就会为你项目中的每一个 XML 布局文件自动生成一个对应的绑定类（例如 activity_main.xml 对应 ActivityMainBinding）。通过实例化这个绑定类，你可以直接以属性的方式安全、快速地访问布局中的所有控件，既减少了模板代码，又避免了因 ID 错误导致的空指针异常。

Q5：接手别人的项目跑不起来，通常需要检查哪“三件套”的版本匹配？

A：

JDK 版本：确认项目 Settings 中的 Gradle JDK 是否符合项目要求（新版本 AS 默认自带并推荐 JDK 17）。
Gradle 版本：包括 Gradle 本体版本（gradle-wrapper.properties）和 Android Gradle Plugin 插件版本（项目根目录的 build.gradle），两者需互相匹配。
SDK 版本：检查模块 build.gradle 中的 compileSdk 和 targetSdk。如果本地缺少对应的 API 版本，需要进入 SDK Manager 中进行下载补充。