Android 开发环境配置：从零搭好你的第一套工具链

很多人学 Android 卡在最前面——代码还没写，环境先劝退。其实 Android 的开发环境可以用一句大白话概括：

一门语言 + 一个 JDK + 一套 Android SDK + 一个 IDE。

把这四样装对、连好，剩下的就是写代码的事。下面按”先装什么、为什么、怎么验证”的顺序，一步一步走完。

Android 应用开发所需环境
┌─────────────────────────────────────────────┐
│  你的代码（Java / Kotlin）          │
├─────────────────────────────────────────────┤
│  Android SDK（平台、构建工具、平台工具）     │  ← 用 SDK Manager 管理
├─────────────────────────────────────────────┤
│  JDK（Java 开发工具包，编译运行时依赖）     │  ← JDK 17 推荐
├─────────────────────────────────────────────┤
│  IDE（Android Studio，集成以上一切）      │  ← 官方唯一指定
└─────────────────────────────────────────────┘

一、先装 JDK：编译的底座

Android 应用开发使用的是 Java 语言（现在官方也主推 Kotlin，但 Kotlin 最终也跑在 JVM 上），所以首先需要 Java 开发环境。

• 现代开发推荐 JDK 17（Android Studio Hedgehog 起默认要求 JDK 17）。
• 好消息是：Android Studio 自带一套 JDK，多数情况下你不用单独下载配置。
• 如果你习惯自己管理，可到 Oracle 官网 或 Adoptium（Eclipse Temurin） 下载安装，安装后设置 JAVA_HOME 指向安装目录即可。

验证：命令行输入 java -version，能看到版本号即成功。

二、装 Android Studio：官方一体化 IDE

Google 现在提供的官方集成开发环境是 Android Studio，它把”定制版 IntelliJ IDEA + Android SDK + 模拟器 + 构建系统（Gradle）”全部打包好了，下载安装即可用。

下载地址：developer.android.com/studio

安装过程基本是”下一步到底”，安装向导会顺带帮你下载最新的 SDK 和构建工具。

历史注记（了解即可，不用照做）：早期 Android 开发用的是 Eclipse + ADT 插件，后来 Google 推出基于 IntelliJ IDEA 的 Android Studio。如今 Eclipse ADT 早已废弃停止维护，新项目一律用 Android Studio。当年还有人推荐先从 IntelliJ IDEA 过渡，现在已无必要——直接用 Android Studio 就好。

国内下载慢怎么办

官方站点有时访问不稳定，可用国内镜像站下载安装包：

• 清华大学开源软件镜像站：https://mirrors.tuna.tsinghua.edu.cn/
• 阿里云镜像：https://mirrors.aliyun.com/

（早期社区里流行用 GitHub 上的 AndroidDevTools 收集的各种离线包，现在 Android Studio 已足够成熟，优先走官方或上述镜像站即可。）

三、安装并配置 Android SDK

SDK（Software Development Kit）是 Android 开发的核心资源包，包含不同系统版本的 API、构建工具、平台工具等。

Android Studio 安装时一般会默认帮你装好一份 SDK，默认路径在：

Windows: C:\Users\<你的用户名>\AppData\Local\Android\Sdk
macOS:   ~/Library/Android/sdk
Linux:   ~/Android/Sdk

如果你想自定义路径（比如放到 D:\sdk\android-sdk-windows），在 Android Studio 的 Settings → Android SDK → Android SDK Location 里改即可。

通过 SDK Manager 选择版本

打开 SDK Manager（菜单 Tools → SDK Manager，或欢迎界面的 Configure），你会看到：

• SDK Platforms：不同 Android 版本（API Level）的系统镜像，勾选你目标调试的版本下载。
• SDK Tools：构建工具、平台工具、模拟器、NDK 等。

新手建议至少勾选：最新稳定版 SDK Platform + Android SDK Build-Tools + Android SDK Platform-Tools + Android Emulator。

国内镜像加速（可选）

SDK 的部分资源在国内访问慢，可在 SDK Manager 里配置镜像。早期社区整理过一批高校镜像服务器，部分至今仍可用：

配置方法：

1. 启动 SDK Manager，打开主界面，依次选择 Tools → Options，弹出 Settings 窗口；
2. 在 HTTP Proxy Server 和 HTTP Proxy Port 填入上面镜像地址（不含 http://），并勾选 「Force https://… sources to be fetched using http://…」；
3. 依次选择 Packages → Reload 重新加载。

现代更省事的做法：直接用清华大学 TUNA 或 阿里云 的 dl.google.com 反向代理镜像，在 Settings 里把 SDK Update Sites 的地址替换为镜像 URL，或在系统 hosts / 网络层做代理，体验更顺滑。

四、配置环境变量（命令行工具需要）

如果你只用 Android Studio 图形界面，可以不用手动配环境变量。但一旦要用命令行跑 adb、fastboot、gradle 等，就得把 SDK 的目录暴露给系统。

以 Windows 为例：

1. 新建系统变量 ANDROID_SDK_HOME

变量值是你的 SDK 路径，例如：

D:\sdk\android-sdk-windows

（若用 Android Studio 默认路径，则填 C:\Users\<用户名>\AppData\Local\Android\Sdk）

2. 编辑 Path 变量，追加两条路径：

;%ANDROID_SDK_HOME%\platform-tools;%ANDROID_SDK_HOME%\tools;

配置完成后，命令行输入 adb version，能显示版本即配置成功。

五、SDK 目录结构：你得知道钱花在哪

打开 SDK 安装目录，会看到几个关键文件夹，理解它们能让你少踩很多坑：

一句话记忆：platforms 是”系统版本库”，build-tools 是”打包车间”，platform-tools 是”调试通道”。

六、三个必须分清的”版本号”

这是 Android 配置里最容易混淆、也最关键的一组概念。无论哪一年学 Android，这四行都得刻进脑子里。

1. compileSdkVersion（编译版本）

你编译 APK 时使用的 SDK 版本号，也就是 API Level，例如 API 23、API 34。

它决定你的 IDE 在编译时能调用哪些 API。注意：它只影响”编译期能用到的新特性”，不会让你的 App 在低版本手机上获得那些特性。

2. buildToolsVersion（构建工具版本）

你打包工具（aapt、dx 等）的版本，目录位于 your_sdk_path/build-tools/XX.XX.XX。

可以用高版本的 build-tool 去构建低版本的 SDK 工程，比如：

compileSdkVersion 18
buildToolsVersion "22.0.1"

这样也是 OK 的。不显式设置时，默认使用已安装的最新版本。

3. minSdkVersion（最低运行版本）

Is the earliest release of the Android SDK that your application can run on.

你的 App 能安装运行的最低 Android 版本。设成 21（Android 5.0），就意味着 5.0 以下的手机装不了你的 App。设得越低，覆盖设备越多，但要处理的兼容问题也越多。

4. targetSdkVersion（目标版本）

The version your application was targeted to run on. Ideally this is because of some sort of optimal run conditions.

你主要面向、优化过的版本。系统会根据它来决定是否启用某些新行为/限制。建议尽量跟随最新稳定版，避免老旧行为带来的安全隐患。

在 build.gradle 里怎么写

旧式写法（仍广泛存在于老项目）：

android {
  compileSdkVersion 23
  buildToolsVersion "23.0.1"

  defaultConfig {
    minSdkVersion 18
    targetSdkVersion 23
  }
}

现代 Kotlin DSL 写法（新项目默认）：

android {
  compileSdk = 34
  buildToolsVersion = "34.0.0"

  defaultConfig {
    minSdk = 21
    targetSdk = 34
  }
}

黄金法则：compileSdk 与 targetSdk 尽量保持一致并跟随最新稳定版；minSdk 根据你想覆盖的设备范围取最低。

七、跑起来：模拟器与真机

环境装好，得能运行才能验证。两种方式：

方式一：AVD 模拟器（虚拟手机）

1. 打开 AVD Manager（Tools → AVD Manager）；
2. 点 Create Virtual Device，选一个设备型号（如 Pixel 6）；
3. 选一个已下载系统镜像的 API 版本（如 API 34）；
4. 一路 Next 完成，点击 ▶ 启动模拟器。

建议选 x86 / x86_64 架构镜像并开启 Intel HAXM / Windows Hypervisor Platform 加速，否则模拟器会非常卡。

方式二：真机调试（推荐）

用数据线连上 Android 手机，手机端开启 开发者选项 → USB 调试，Android Studio 顶部的设备下拉里就能看到它，直接 Run 即可。

真机调试比模拟器快得多，也最贴近真实用户环境。

八、验证：创建第一个项目

1. 打开 Android Studio，选 New Project → Empty Activity；
2. 语言选 Kotlin（或 Java），Minimum SDK 选 21；
3. 点 Finish，等 Gradle 同步完成；
4. 连上设备 / 启动模拟器，点工具栏的 ▶ Run。

屏幕出现 “Hello Android” 字样，恭喜——你的开发环境配置完成。

九、常见问题速查

十、结语

Android 开发环境配置的本质，就是把”语言—JDK—SDK—IDE”四件套正确接起来。现代方案已经比早年（Eclipse + 翻墙下载 + 手动配环境变量）简单太多：装一个 Android Studio，剩下的它替你管。

你真正需要理解并记住的，是 SDK 目录结构 和 compile / min / target 三个版本号——它们不会因为工具更新而过时。把这篇的配置走通一遍，下一次新建项目，你就能把精力真正放在写代码、做产品上。

关联阅读：环境就绪后，可继续看 初学 Java 从这里开始 补齐 Java 语言基础；理解 Android 跨设备运行的底层原理，参见 JAVA 虚拟机与跨平台特性。