跳转到内容

1.1 实验:搭建 Android 开发环境

在安装 Android Studio 之前,先确认电脑满足基本要求,并规划好 SDK 的存储位置。


1.1 系统要求确认

项目最低要求推荐配置
操作系统Windows 8 64位Windows 10/11 64位
内存(RAM)8 GB16 GB 及以上
硬盘可用空间8 GB16 GB 及以上(SSD 最佳)
屏幕分辨率1280×8001920×1080
CPU支持虚拟化(VT-x / AMD-V)近 3 年内主流 CPU

1.2 规划 SDK 存储路径

Android SDK 会占用约 3-8 GB 的磁盘空间,安装前建议先规划好存放位置,避免后续需要迁移。

推荐路径示例:

D:\Android\SDK

⚠️ 注意事项

  • 路径中不能含有中文字符
  • 路径中不能含有空格(如 My Android\SDK 会报错)
  • 建议放在非 C 盘(避免系统盘空间紧张)

记住这个路径,后续配置向导中需要填写。

┌─────────────────────────────────────┐
│ ✅ 正确示例 │
│ D:\Android\SDK │
│ E:\dev\AndroidSDK │
│ │
│ ❌ 错误示例 │
│ C:\用户\我的文档\Android SDK │ ← 含中文
│ D:\My Android\SDK │ ← 含空格
└─────────────────────────────────────┘

2.1 打开下载页面

打开浏览器,访问 Android Studio 官方下载页:

https://developer.android.google.cn/studio?hl=zh-cn

上面这个地址是 Google 面向中国大陆提供的镜像站,在国内网络下访问更稳定。


2.2 确认版本

本文以 Android Studio Panda 2 | 2025.3.2 为示例,其他版本的安装流程基本一致。

页面会自动推荐最新版本。

Android Studio 下载页面示例

2.3 下载安装包

点击下载按钮后,会弹出许可协议确认框:

Android Studio 许可协议示例

勾选同意,点击 下载 开始下载。

下载文件名类似:

android-studio-panda2-windows.exe

文件大小约 1.3 GB

3.1 用户控制权限确认

安装 Android Studio 需要管理员权限。若弹出 Windows 用户账户控制(UAC)提示,点击

Windows 用户控制权限示例

3.2 运行安装程序

下载完成后,双击 .exe 安装包。若出现 Windows 安全警告,点击 运行

Windows 安全警告示例

3.3 欢迎页

进入安装向导,直接点击 Next

Android Studio 安装欢迎页示例

3.4 选择安装组件

安装选项中,Android Studio 为必选。Android Virtual Device 在本步骤可不勾选(后续单独创建模拟器)。确认后点击 Next

Android Studio 组件选择示例

3.5 选择安装路径

Android Studio 安装路径示例
  • 如果 C 盘空间充足(建议至少剩余 20 GB),保持默认路径即可
  • 如需更改,点击 Browse 选择其他路径,例如 D:\Android\AndroidStudio
  • ⚠️ 路径中不能有中文或空格

确认后点击 Next


3.6 选择开始菜单文件夹名称

选择开始菜单文件夹名称

此步骤用于设置开始菜单文件夹名称。默认值为 “Android Studio”,也可按需修改(如 “My Android Studio”)。设置后点击 Install

如不需要创建开始菜单快捷方式,可勾选 “Don’t create a Start Menu folder”。


3.7 开始安装

点击 Install 开始安装,等待约 3-5 分钟:

安装过程中

3.8 安装完成

安装完成后,点击 Next 进入完成页面。

在完成页面勾选 Start Android Studio,点击 Finish。安装向导关闭后会自动启动 Android Studio。

安装完成
完成安装,准备启动

首次启动时,Android Studio 会运行 Setup Wizard,用于下载 Android SDK 与相关组件。请按以下步骤完成配置。


4.1 向导欢迎页

进入 Setup Wizard 后,点击 Next

安装向导欢迎页

4.2 选择是否发送匿名使用数据

向导会询问是否发送匿名使用数据。选择 Send usage statistics to GoogleDon’t send 后,点击 Next

是否发送匿名使用数据

4.3 拉取可用组件信息

向导会尝试拉取可用 SDK 组件信息。若出现无法访问组件列表提示,可按以下方式处理:

先点击弹窗中的 Cancel,再点击页面底部 Next 继续。

拉取可用的组件信息
无法访问组件列表的提示(正常现象)

4.4 选择安装类型

安装类型请选择 Custom

安装类型选择

说明:
选择 Custom 可手动指定 SDK 路径(如 D:\Android\SDK),避免占用过多系统盘空间。

选择 Custom,点击 Next


4.5 配置 SDK 路径与组件(关键步骤)

在此步骤中,确认 SDK 安装路径(建议使用预先规划的路径,如 D:\Android\SDK),并保持默认选中组件:

如果页面中出现 Android Virtual Device 选项,请暂不勾选。

SDK 组件设置

修改 SDK Location 的步骤:

  1. 点击路径输入框右侧的 📁 文件夹图标
  2. 在弹出的文件夹选择窗口中,导航到你规划好的路径(如 D:\Android\SDK
  3. 如目标文件夹不存在,可直接在输入框手动输入路径,Android Studio 会自动创建

组件说明:

组件说明是否需要
Android SDKSDK 核心工具✅ 必须
Android SDK Platform (API 36)Android 16 平台库✅ 必须
Android Emulator Hypervisor Driver模拟器加速驱动✅ 建议勾选
Android SDK Platform-ToolsADB 等调试工具✅ 必须
Android Virtual Device默认模拟器配置文件❌ 暂不勾选

点击 Next


4.6 确认配置

向导会将待下载的组件列表和总下载大小显示出来,确认无误后点击 Next

SDK 组件设置

4.7 阅读并同意许可协议

在此页面中,你需要阅读并同意各个组件的许可协议才能继续安装。请点击 Accept,最后点击 Next

组件许可协议

4.8 下载并安装组件

下载组件的过程大约需要 15-60 分钟,取决于网络状况:

下载组件中
下载完成

下载说明:
SDK 通过 dl.google.com 下载。若下载速度长期低于 100 KB/s,请参考本文末尾“常见安装问题排查”中的处理方法。

4.9 完成向导

下载完成后进入完成页面,点击 Finish。出现 Android Studio 欢迎页后,向导配置完成。

安装完成,欢迎使用 Android Studio

安装向导完成后,我们需要确认 SDK 已正确安装。


5.1 打开 Android Studio 设置页

在 AS 欢迎页,点击左下角的 ⚙ 齿轮图标,选择 Settings

打开Android Studio设置页

5.2 确认 Android SDK 安装路径和 SDK 版本

在设置页左侧导航中,展开 Languages & Frameworks,选择 Android SDK。页面顶部会显示 Android SDK Location。 检查该路径是否与向导中设置的一致(如 D:\Android\SDK)。同时确认组件列表中 Android SDK Platform (API 36) 的状态为 Installed

确认SDK已安装
  • 如果显示 Not installedUpdate available,勾选该行后点击右下角的 Apply 重新下载。
  • 如果要安装其他版本的 SDK,在此页面,勾选需要的版本后点击页面右下方的 Apply 进行安装。

6.1 打开设备管理器

在 AS 欢迎页,点击右上角的 ⚙ 齿轮图标,选择 Virtual Device Manager

打开设备管理器

6.2 新建虚拟设备

点击 Device Manager 面板中间的 Create virtual device 按钮:

创建虚拟设备

6.3 步骤一:选择设备型号

Select Hardware 窗口中,选择 Pixel 9

选择设备型号

选择 Pixel 9,点击 Next

为什么推荐 Pixel 9?
Pixel 系列是 Google 官方设备,具有最好的兼容性,1080×2424 分辨率也与主流 Android 手机一致。


6.4 步骤二:选择系统镜像

切换到 Recommended 标签页,找到 API 36

选择系统镜像

在此页面中,你需要选择一个系统镜像(System Image)来安装到模拟器上,系统镜像包含了 Android 操作系统的核心文件和库,是模拟器能够运行的基础。

默认情况下,AS 会推荐一个适合的系统镜像(如 API 36),如果旁边显示下载图标,说明该镜像尚未下载,需要点击下载后才能使用。

情况 A:系统镜像已下载

直接点击选中系统镜像名称,点击 Next,跳到步骤三。

情况 B:系统镜像右侧有下载图标(未下载)

  1. 点击镜像名称前面的下载图标
  2. 开始下载系统镜像(约 900 MB - 1.5 GB)
  3. 下载完成后,点击 Finish

系统镜像约 1-1.5 GB,下载时间视网络环境约 5-30 分钟。

点击下载系统镜像
下载系统镜像中
下载系统镜像完成

下载完成后,选中系统镜像名称,点击 Next


6.5 步骤三:确认模拟器创建完成

Device Manager 列表中将出现 Pixel 9 设备,说明模拟器创建成功。

模拟器创建成功

6.6 启动模拟器

点击 Pixel 9 设备右侧的 ▶ 启动按钮

点击启动模拟器

6.7 等待模拟器启动

模拟器窗口弹出后,启动过程分几个阶段:

启动阶段 1:黑屏启动
启动阶段 2:加载动画
启动阶段 3:显示系统桌面

首次启动较慢,请耐心等待 1-3 分钟。
后续再次启动会快很多,因为系统已经缓存。


6.8 验证启动成功

进入系统桌面后,说明模拟器启动成功,环境搭建完成。

建议将系统语言切换为中文(中国),确认界面显示正常。

7.1 什么是 ADB

ADB(Android Debug Bridge,安卓调试桥)是 Android SDK 自带的命令行工具,安装 Android Studio 时已一并下载,无需单独安装。

通过 ADB,可以在电脑终端与手机或模拟器进行通信,常见用途包括:

  • 查看当前连接的设备列表(adb devices
  • 在设备上安装/卸载 APK
  • 查看应用日志(Logcat)
  • 向模拟器发送截图、文件等

Android Studio 内部已经通过 GUI 调用了 ADB,但将其添加到系统 PATH 后,也可以在任意命令提示符窗口中直接使用 adb 命令,在某些调试场景下会更便捷。


7.2 找到 ADB 所在路径

ADB 可执行文件位于 Android SDK 目录下的 platform-tools 子文件夹。

在 Android Studio 中,依次点击菜单 File → Settings(Mac 为 Android Studio → Settings),在左侧展开 Languages & Frameworks → Android SDK,页面顶部的 Android SDK Location 即为 SDK 完整路径。

Android Studio SDK 设置

将该路径复制出来,在末尾加上 \platform-tools,即为 ADB 所在路径。例如 SDK 路径为 D:\Android\SDK,则 ADB 路径为 D:\Android\SDK\platform-tools


7.3 打开环境变量设置

有两种方式:

方式一(推荐):Win + S,搜索”编辑系统环境变量”,点击打开。

方式二: 右键”此电脑”→“属性”→“高级系统设置”→“环境变量”。


7.4 添加路径到 Path

在弹出的”环境变量”窗口中:

  1. 上方的”用户变量”(或下方的”系统变量”均可)中找到 Path,双击打开。
  2. 点击右侧”新建”,粘贴第 7.2 步中的 platform-tools 路径。
  3. 依次点击”确定”关闭所有窗口。
添加环境变量

7.5 验证是否生效

重新打开 一个命令提示符(Win + R → 输入 cmd → 回车),运行:

adb version

如果输出类似以下内容,说明配置成功:

Android Debug Bridge version 1.0.41
Version 35.0.2-...
ADB 配置成功示例
ADB 配置失败示例

8.1 SDK 下载速度极慢

现象: 配置向导或 SDK Manager 中下载速度长期低于 100 KB/s,甚至无法下载。

原因: dl.google.com 的路由在部分网络(如校园网)可能不稳定。

解决方案:

方案 A:更换网络环境
切换到手机热点(4G/5G)重新尝试,通常比校园网快。

方案 B:在 AS 中配置 HTTP 代理(如果你有可用代理)

  1. 打开 AS → File → Settings
  2. 左侧导航:Appearance & Behavior → System Settings → HTTP Proxy
  3. 选择 Manual proxy configuration,填入代理地址和端口
  4. 点击 Check connection 验证
  5. 点击 OK,重启 AS 后重新下载

方案 C:使用老师提供的离线安装包
如果网络实在无法下载,可以使用老师提前下载好的 SDK 组件,直接复制到 SDK 目录。


8.2 模拟器启动后始终黑屏

现象: 模拟器窗口弹出,但等待很久后屏幕始终是黑的,没有 Android Logo。

可能原因 1:首次启动时间正常,继续等待
首次启动最长可能需要 3-5 分钟,先确认等了足够长时间再排查。

可能原因 2:图形渲染模式有问题
在 Device Manager 中右键点击模拟器 → 选择 Edit → 展开 Advanced Settings → 将 GraphicsAutomatic 改为 Software → 重新点击启动。

┌────────────────────────────────────────────┐
│ Advanced Settings │
│ │
│ Emulated Performance │
│ Graphics: [ Software ▼ ] ← 改成这个 │
│ │
│ [ Finish ] │
└────────────────────────────────────────────┘

可能原因 3:模拟器数据损坏
在 Device Manager 中右键点击 → Wipe Data(清除数据),再重新启动。


8.3 模拟器启动极慢或报 Hypervisor 警告

现象: 模拟器报类似 “Your CPU might not support virtual machine acceleration” 的警告,或启动极慢(超过 10 分钟)。

原因: 电脑的 CPU 虚拟化功能未开启,模拟器无法使用硬件加速,只能以纯软件方式运行。

排查方式: 打开任务管理器(Ctrl + Shift + Esc)→ 性能 → CPU,查看右下角是否显示”虚拟化:已启用”。

┌────────────────────────────────────────────────────┐
│ 任务管理器 → 性能 → CPU │
│ │
│ CPU 使用率 30% │
│ 速度 2.4 GHz │
│ ... │
│ 虚拟化: 已启用 ← ✅ 这个状态表示正常 │
│ (或"已禁用" ← ❌ 需要进 BIOS 开启) │
└────────────────────────────────────────────────────┘

多数现代电脑(2018 年后出厂)已默认开启虚拟化,任务管理器里大概率显示”已启用”。
若显示”已禁用”,请重启电脑进入 BIOS 开启 VT-x(Intel)或 AMD-V(AMD),具体步骤可以搜索你的电脑品牌 + “开启虚拟化”。


8.4 安装路径报错或 AS 启动异常

现象: 安装过程中提示路径无效,或 AS 启动时报错无法找到 SDK。

原因: 路径含有中文、空格或特殊字符。

解决: 打开 File → Settings → System Settings → Android SDK,将 SDK Location 修改为纯英文、无空格的路径(如 D:\Android\SDK),点击 Apply


8.5 杀毒软件拦截

现象: 安装或运行时,360 安全卫士、火绒等杀毒软件弹出拦截提示。

解决: 将以下目录加入杀毒软件的信任区 / 白名单,然后重新运行:

C:\Program Files\Android\Android Studio\ ← AS 安装目录
D:\Android\SDK\ ← SDK 目录(替换为你的实际路径)
C:\Users\你的用户名\.gradle\ ← Gradle 缓存
C:\Users\你的用户名\AndroidStudioProjects\ ← 项目目录

8.6 HAXM 安装失败的提示

现象: 向导中出现 HAXM 安装失败,或提示 “Hyper-V is enabled, HAXM cannot be installed”。

解释: HAXM 是老版本的模拟器加速方案,从模拟器 36.2 版本起已不再使用 HAXM,可以直接忽略此提示。当前 AS 版本默认使用 Android Emulator Hypervisor Driver (AEHD)Windows Hypervisor Platform (WHPX),两者均与 Hyper-V 兼容,无需处理。