要在本地电脑上搭建一个能真正跑起来的安卓开发环境，说复杂也复杂，说简单也简单。

核心就三件事：

• 下载安装 Android Studio
• 配好 SDK
• 搞定 JDK 环境变量

这三步一个都不能少，否则新建项目大概率会卡在 Gradle 同步，或者连设备都识别不了。

下载 Android Studio 安装包

直接去官方站点：https://developer.android.google.cn/studio。

点击醒目的【Download Android Studio】按钮。页面会自动识别你的操作系统（Windows/macOS/Linux），并给出对应的安装包。

注意：别从第三方站点下载。捆绑软件、哈希值被篡改这类风险犯不上冒。

下载完别急着双击，先校验文件完整性。

• Windows 用户：打开 PowerShell，执行 Get-FileHash -Algorithm SHA256 AndroidStudioSetup.exe，然后跟官网公布的 SHA-256 值比对一下。
• macOS 用户：用终端执行 shasum -a 256 android-studio-*.dmg。

这一步看着麻烦，但省掉的话，万一装完启动报错“invalid archive”，还得回头重来。

安装 Android Studio 主程序

Windows 用户

右键安装包 → 【以管理员身份运行】→ 勾选同意协议。

关键一步：安装路径必须是全英文、无空格、无中文，例如 D:AndroidStudio。否则后续 Gradle 构建会因为路径解析失败直接中断，到时候你都不知道错在哪儿。

macOS 用户

双击 .dmg 文件 → 把 Android Studio 图标拖进 Applications 文件夹。

启动时如果提示“已损坏”，别慌。去【系统设置 → 隐私与安全性】下滑到底，点击【仍要打开】即可。

安装过程中务必勾选 Android Virtual Device 组件。即便你打算全程用真机调试，AVD 也是验证 UI 适配和 API 兼容性的必备后备手段——说白了，有些问题只有模拟器上才能提前暴露。

首次启动与 SDK 初始化配置

启动 Android Studio，Welcome 界面选【Do not import settings】。新手别导入旧配置，容易造成 SDK 路径冲突。

进入主界面后，立刻点击右下角【Configure → SDK Manager】。

先切到【SDK Platforms】页签，勾选至少一个最新稳定版，比如 Android 14 / API 34。点击【Apply】开始下载。

然后切到【SDK Tools】页签，勾选下面三项：

• Android SDK Build-Tools（选最新稳定版，比如 34.0.0）
• Android Emulator
• Android SDK Platform-Tools

点击【OK】→ 接受许可证 → 接下来就是等。这一步耗时较长，网络不好的话可以勾选【Show Package Details】，手动取消下载体积较大的模拟器系统镜像（比如 x86_64 Android TV），能省不少带宽。

JDK 与环境变量配置

Android Studio 从 2024.2 版本开始内置了 JetBrains Runtime（JBR），但命令行工具（adb、gradlew 等）仍然依赖系统级的 JDK。

所以还得单独装 JDK 17——目前最新的推荐 LTS 版本。

访问 https://adoptium.net/ 下载 Eclipse Temurin JDK 17（LTS）。安装时务必勾选【Add to PATH】选项，省得后面手动配。

接下来配 Android SDK 环境变量：

Windows

系统属性 → 高级 → 环境变量 → 新建系统变量 ANDROID_HOME = D:AndroidStudiosdk（路径按你实际安装位置填）。

然后编辑 Path 变量，新增两行：

• %ANDROID_HOME%platform-tools
• %ANDROID_HOME%emulator

macOS/Linux

在 ~/.zshrc 或 ~/.bash_profile 中追加：

• export ANDROID_HOME=$HOME/Library/Android/sdk
• export PATH=$PATH:$ANDROID_HOME/platform-tools:$ANDROID_HOME/emulator

保存后执行 source ~/.zshrc 让配置生效。

验证环境是否就绪

打开终端（Windows 用 CMD 或 PowerShell，macOS/Linux 用 Terminal），依次敲下面三个命令：

• ja va -version → 应该显示“17.x.x”字样；
• adb version → 应该返回“Android Debug Bridge version 34.x.x”；
• sdkmanager --list_installed → 列出已安装的 SDK 组件，确认没有报错，并且能看到类似 platforms;android-34 的条目。

三条命令都返回预期结果，就说明 Android Studio、SDK、JDK、adb、emulator 五者全部连通，环境搭建完成。这时候你再新建项目，Gradle 同步基本就是秒过。