引言：为什么你的环境总出问题？
很多新手开发者在初次使用 Android Studio 时，往往急于创建第一个'Hello World'，而忽略了底层环境的配置。结果在后续导入项目、升级版本或使用特定库时，频频遭遇 Unsupported class file major version、SDK location not found 等令人头疼的错误。
究其根本，是对 JDK（Java 开发工具包）和 Android SDK（软件开发工具包）的作用与关系理解不清。本文将为你彻底厘清这两个核心组件，并提供从零开始的详细配置指南与避坑秘籍。
一、核心概念：JDK 与 SDK 究竟是什么？
在开始配置之前，我们需要明确这两个工具包的职责。
- JDK（Java Development Kit）：这是 Java 程序的编译和运行环境。因为 Android 应用最初是用 Java 编写的，且其构建系统（Gradle）本身也是 Java 程序，所以 JDK 是 Android Studio 工作的绝对前提。
- 关键点：Android Studio 从 Arctic Fox 版本开始，已内置了专门优化过的 JDK（称为 Android JDK 或 JDK 11），用于运行 IDE 本身和 Gradle。但你的项目代码可能需要指定不同版本的 JDK 进行编译。
- Android SDK（Software Development Kit）：这是开发 Android 应用所特有的工具、平台库和模拟器的集合。它包含了你在代码中调用的 Android API 库、用于调试的 adb 工具、性能剖析器以及各种版本的 Android 系统镜像等。
- 关键点：SDK 与 JDK 相互独立。SDK 中的工具（如 aapt）是 C++ 编写的，但编译你的应用代码时，需要 JDK 和 SDK 协同工作。
简单比喻：把开发 App 比作造一辆汽车。
- JDK 像是工厂的通用动力系统和标准化生产线（能加工各种金属零件）。
- Android SDK 则是造汽车专用的模具、图纸和轮胎等特定零件。
- 没有 JDK，整个工厂无法启动；没有 Android SDK，你就造不出具有 Android 特征的汽车。
二、JDK 配置详解：版本选择与路径设置
这是最容易出错的地方。Android Studio 涉及两个 JDK 位置：一个给 IDE 自己用，一个给你的项目用。
1. 如何为项目选择正确的 JDK 版本？
JDK 版本并非越高越好，必须与项目的 Gradle 插件版本和编译兼容性相匹配。建议使用 JDK 11 或更高版本，这是一个安全的起点。
下表列出了常见的版本对应关系：
| 项目编译需求 | 推荐 JDK 版本 | 说明与注意事项 |
|---|---|---|
| 旧项目（维护中） | JDK 8 | 许多老项目将 sourceCompatibility 设为 1.8，使用 JDK 8 最保险。 |
| 大多数现代项目 | JDK 11（LTS） | Android Studio 内置版本，兼容性最好，长期支持，强烈推荐。 |
| 尝试最新特性 | JDK 17（LTS） | 如需使用 record 等新语法，或项目明确要求。注意部分第三方库可 |
| 重要原则 | 项目要求优先 | 打开已有项目时，务必遵循项目根目录下 gradle-wrapper.properties 或 build.gradle 文件中的要求。 |
2. 下载与安装 JDK（以 JDK 11 为例）
- 访问 Oracle 官网或 OpenJDK 站点（如 Adoptium）。推荐使用 OpenJDK 发行版，无需处理 Oracle 的许可问题。
- 选择 JDK 11 (LTS) 对应你操作系统（Windows, macOS, Linux）的安装包。
- 运行安装程序，记住安装路径（如
C:\Dev\Java\jdk-11.0.xx或/Library/Java/JavaVirtualMachines/jdk-11.jdk/Contents/Home）。
3. 在 Android Studio 中配置 JDK
这是核心步骤，确保你的项目使用正确的 JDK。
- 打开项目结构设置：
- Windows/Linux: File → Project Structure…
- macOS: Android Studio → Preferences → Build, Execution, Deployment → Build Tools → Gradle
- 配置 JDK 位置（关键！）：
- 在 Project Structure 对话框左侧选择 SDK Location。
- 你会看到'JDK location'字段。默认可能指向 Android Studio 自带的 JDK。
- 点击右侧的文件夹图标，导航并选择你刚才安装的 JDK 11 的根目录。这样，你的项目就会使用这个指定的 JDK 进行构建。
注意：同界面下的'Android SDK location'是另一个路径，指向 SDK，切勿混淆。
- 在模块级别设置语言版本：
- 在 Project Structure 对话框左侧选择 Modules → 你的 App 模块。
- 在 Source Compatibility 和 Target Compatibility 下拉框中，选择与 JDK 版本对应的语言级别（如选择了 JDK 11，这里可以选 11 或保持 1.8 以兼容旧语法）。
三、Android SDK 配置详解：组件安装与管理
1. SDK Manager：你的'Android 组件商店'
通过 Tools → SDK Manager 打开。这里管理所有 SDK 组件。
- SDK Platforms 标签页：这里下载不同版本的 Android 系统平台。你需要至少下载一个你目标应用的 API 级别平台（例如 Android 13.0 (Tiramisu) API 33）。为了方便测试，建议同时下载更低版本（如 API 28）的平台。
- SDK Tools 标签页：这是精华所在，务必确保以下工具已安装/更新：
- Android SDK Build-Tools：核心构建工具，建议安装最新的稳定版。Gradle 调用的就是它。
- Android SDK Command-line Tools：包含重要的 sdkmanager 命令行工具。
- Android Emulator：如果你要用官方模拟器。
- Android SDK Platform-Tools：包含 adb, fastboot 等关键调试工具。
- Intel x86 Emulator Accelerator (HAXM) 等：用于加速模拟器（如果使用 Intel CPU）。
2. 环境变量配置（可选但建议）
为了在终端或命令行中直接使用 adb, apkanalyzer 等命令，可以配置系统环境变量。
- 找到 SDK 安装路径：在 Android Studio 的 SDK Manager 顶部可以看到。
- 添加系统变量：
- ANDROID_HOME 或 ANDROID_SDK_ROOT：变量值设为 SDK 的根路径（例如
C:\Users\YourName\AppData\Local\Android\Sdk）。 - 修改 Path 变量：添加
%ANDROID_HOME%\platform-tools和%ANDROID_HOME%\tools（或%ANDROID_HOME%\cmdline-tools\latest\bin）。
- ANDROID_HOME 或 ANDROID_SDK_ROOT：变量值设为 SDK 的根路径（例如
验证：打开新终端，输入 adb version，若能显示版本号则配置成功。
四、实战演练：在新项目中验证配置
- 创建一个新的'Empty Activity'项目。
- 打开 File → Project Structure，确认 JDK 和 SDK 路径均已正确指向你自定义的位置。
- 打开项目根目录的 build.gradle.kts (或 build.gradle) 文件，查看 compileSdk 和 targetSdk 版本。这决定了项目使用哪个 SDK 平台版本进行编译和适配。
- 尝试点击 Build → Make Project。如果配置正确，项目应成功编译。
五、常见问题排查（避坑指南）
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| Unsupported class file major version 65 | 项目指定的 JDK 版本（如 17）高于当前使用的 JDK 版本（如 8）。 | 在 Project Structure 中，将项目的 JDK location 设置为更高版本的 JDK，并确保模块的 Target Compatibility 与之匹配。 |
| SDK location not found | Android Studio 无法找到 SDK 路径。可能配置文件损坏或项目是从另一台电脑拷贝的。 | 1. 检查 Project Structure → SDK Location 设置。2. 或检查项目根目录的 local.properties 文件，确保 sdk.dir= 后的路径正确。 |
| Failed to install the following Android SDK packages as some licenses… | 首次安装组件时未接受许可协议。 | 打开终端，进入 SDK 的 cmdline-tools/latest/bin 目录，运行 sdkmanager --licenses，然后一直按 y 接受所有协议。 |
| Gradle 同步慢/失败 | 网络问题，或 Gradle 版本与插件版本不兼容。 | 1. 检查网络，或使用国内镜像。2. 尝试使用 File → Invalidate Caches / Restart。 |
结语：固本强基，方能行远
一次正确的 JDK 和 SDK 配置，能为你的整个 Android 开发生涯打下坚实的基础，避免大量因环境导致的时间浪费。记住核心要点：让项目 JDK 版本与构建要求一致，通过 SDK Manager 安装必要的平台和工具。
总之，高效的开发工具使用习惯能显著提升效率，而这一切都始于一个正确配置的环境。
