跳转到内容

2.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 Google 或 Don’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 installed 或 Update 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 → 将 Graphics 从 Automatic 改为 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 兼容,无需处理。