Android Studio 安装与环境变量配置全攻略 – wiki基地

作者： /

Android Studio 安装与环境变量配置全攻略：从零开始构建你的安卓开发环境

在当今移动互联网时代，Android 应用开发无疑是技术领域的热门赛道。而作为 Android 应用开发的官方 IDE (集成开发环境)，Android Studio 凭借其强大的功能、完善的工具链以及与 Google 官方生态的紧密结合，成为了无数开发者首选的开发利器。然而，对于初学者来说，Android Studio 的安装与环境变量的配置过程可能会显得有些复杂，稍有不慎就可能导致环境搭建失败，从而耽误宝贵的学习和开发时间。

本篇文章将为您提供一份详尽至极的 Android Studio 安装与环境变量配置全攻略，从环境准备、JDK 安装、Android Studio 下载与安装，到核心环境变量的配置（JAVA_HOME、ANDROID_HOME、Path）以及常见问题的排查，每一步都将进行细致入微的讲解，并涵盖 Windows、macOS 和 Linux 三大主流操作系统，确保您能顺利、高效地搭建起属于自己的 Android 开发环境。

第一章：踏上征途前的准备——软硬件与心态

在正式开始安装之前，我们需要做好一些基础的准备工作，这就像建造一座大厦前需要打好地基一样重要。

1.1 硬件要求与建议

虽然 Android Studio 对硬件的要求不像游戏那样苛刻，但为了保证开发的流畅性，避免卡顿和漫长的编译等待，我们强烈建议您的设备满足以下条件：

  • 操作系统：
    • Windows： Windows 8/10/11 (64位)
    • macOS： macOS 10.14 (Mojave) 或更高版本
    • Linux： GNOME、KDE 或 Unity DE 的 64 位发行版 (例如 Ubuntu 18.04 LTS 或更高版本)
  • 内存 (RAM)：
    • 最低： 8 GB RAM (Android Studio 自身 + 模拟器)
    • 推荐： 16 GB RAM 或更高 (特别是当您需要同时运行多个应用或虚拟机时)
  • 硬盘空间：
    • 最低： 8 GB 可用空间 (IDE + Android SDK + 模拟器系统镜像)
    • 推荐： 128 GB SSD (固态硬盘) 或更高。SSD 的读写速度远超 HDD (机械硬盘)，能显著提升启动、编译和模拟器运行速度。
  • 屏幕分辨率： 1280 x 800 或更高。
  • 处理器 (CPU)：
    • 最低： 64 位处理器。
    • 推荐： 支持 Intel VT-x、Intel EM64T (Intel 处理器) 或 AMD-V (AMD 处理器) 的多核处理器。这些虚拟化技术对运行 Android 模拟器至关重要。

1.2 网络连接

整个安装过程中，尤其是下载 Android SDK 组件时，需要稳定且速度较快的互联网连接。因为 Android SDK 组件文件通常较大，且数量繁多。

1.3 保持耐心与细致

安装和配置环境变量可能涉及一些命令行操作和系统设置，务必按照本教程的步骤一步一步来，仔细核对每一步的路径和命令，保持耐心。

第二章：核心基石——Java Development Kit (JDK) 的安装与 JAVA_HOME 配置

Android Studio 是基于 Java 开发的，同时 Android 应用的构建也依赖于 Java 环境。因此，在安装 Android Studio 之前，我们必须先安装 Java Development Kit (JDK)，并正确配置其环境变量 JAVA_HOME。

2.1 选择合适的 JDK 版本

过去，Oracle JDK 是主流选择，但自 JDK 11 之后，Oracle JDK 的商业使用需要付费许可。对于个人学习和开发，我们推荐使用OpenJDK。例如，Adoptium OpenJDK (原 AdoptOpenJDK) 是一个非常受欢迎且稳定的 OpenJDK 发行版。

  • 推荐版本： OpenJDK 11 或 OpenJDK 17。Android Studio 的最新版本通常推荐使用这些 LTS (长期支持) 版本。

2.2 下载 JDK

访问 Adoptium 官网：https://adoptium.net/

  1. 在首页选择您需要的 JDK 版本 (例如 Temurin 17 (LTS) 或 Temurin 11 (LTS))。
  2. 确保操作系统和架构与您的设备匹配 (例如 x64)。
  3. 下载对应的安装包：
    • Windows： msi 安装包 (推荐)
    • macOS： pkg 安装包
    • Linux： tar.gz 压缩包

2.3 安装 JDK

2.3.1 Windows 用户
  1. 双击下载的 msi 安装包，启动安装向导。
  2. 一路点击“Next”或“下一步”，直到安装完成。请记下 JDK 的安装路径，通常是 C:\Program Files\Eclipse Adoptium\jdk-xx.x.x.xxx (xx.x.x.xxx 是版本号)。
    • 重要提示： 在某个步骤中，安装程序可能会询问是否设置 JAVA_HOME 环境变量。如果您选择设置，后续可以跳过手动配置 JAVA_HOME 的步骤。但为了教学的完整性和理解原理，本文仍会详细讲解手动配置。
2.3.2 macOS 用户
  1. 双击下载的 pkg 安装包，启动安装向导。
  2. 按照提示点击“继续”、“安装”，输入您的系统密码，直到安装完成。
  3. macOS 上的 JDK 通常安装在 /Library/Java/JavaVirtualMachines/jdk-xx.x.x.jdk/Contents/Home 目录下。
2.3.3 Linux 用户
  1. 将下载的 tar.gz 压缩包解压到您希望安装 JDK 的位置。通常推荐解压到 /usr/local/java/ 或您的用户主目录下的某个目录。
    bash
    # 例如解压到 /usr/local/java/ (需要管理员权限)
    sudo mkdir -p /usr/local/java
    sudo tar -zxvf /path/to/your/jdk-xx.x.x_linux-x64_bin.tar.gz -C /usr/local/java/
    # 解压后，会生成一个类似 jdk-xx.x.x 的目录
    # 比如：/usr/local/java/jdk-17.0.x

2.4 配置 JAVA_HOME 环境变量

JAVA_HOME 环境变量指向 JDK 的安装根目录，许多 Java 应用程序（包括 Android Studio）会通过它来查找 Java 环境。

2.4.1 Windows 用户
  1. 打开系统环境变量设置：
    • 右键点击“此电脑”或“我的电脑” -> “属性” -> “高级系统设置” -> “环境变量”。
    • 或者在搜索栏中输入“环境变量”，选择“编辑系统环境变量”。
  2. 新建 JAVA_HOME 变量：
    • 在“系统变量”区域，点击“新建…”按钮。
    • 变量名：JAVA_HOME
    • 变量值：填写您 JDK 的安装路径，例如 C:\Program Files\Eclipse Adoptium\jdk-17.0.x.xxx。
    • 点击“确定”。
  3. 编辑 Path 变量：
    • 在“系统变量”区域，找到名为 Path 的变量，双击或点击“编辑”。
    • 点击“新建”，添加 %JAVA_HOME%\bin。
    • 点击“确定”，直到关闭所有环境变量窗口。
  4. 验证：
    • 打开 新的 命令提示符 (CMD) 或 PowerShell 窗口（旧窗口可能不会立即刷新环境变量）。
    • 输入命令：java -version
    • 如果显示 JDK 的版本信息，说明配置成功。
    • 输入命令：javac -version
    • 如果也显示版本信息，则更进一步确认配置无误。
2.4.2 macOS 用户

macOS 下 JDK 的安装通常会自动配置好，但为了确保或手动配置，可以这样做：

  1. 确定 JDK 路径：
    bash
    /usr/libexec/java_home -v 1.8 # 检查Java 8的路径
    /usr/libexec/java_home -v 11 # 检查Java 11的路径
    /usr/libexec/java_home -v 17 # 检查Java 17的路径
    您会得到一个路径，例如 /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home。
  2. 编辑配置文件： 打开终端，编辑您的 Shell 配置文件。常用的有 ~/.bash_profile (对于 Bash 用户) 或 ~/.zshrc (对于 Zsh 用户，macOS Catalina 及以上版本默认)。
    bash
    # 如果是 Bash
    nano ~/.bash_profile
    # 如果是 Zsh
    nano ~/.zshrc
  3. 添加或修改内容： 在文件末尾添加以下两行（将 jdk-xx.x.x.jdk 替换为您的实际 JDK 目录名）：
    bash
    export JAVA_HOME=$(/usr/libexec/java_home -v 17) # 根据您安装的JDK版本修改
    export PATH=$JAVA_HOME/bin:$PATH
    或者直接指定路径：
    bash
    export JAVA_HOME=/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home
    export PATH=$JAVA_HOME/bin:$PATH
    保存并退出 (Nano 编辑器：Ctrl+O 回车，Ctrl+X 退出)。
  4. 使配置生效： 在终端中执行以下命令，或者重新打开一个终端窗口：
    bash
    source ~/.bash_profile # 如果是 Bash
    source ~/.zshrc # 如果是 Zsh
  5. 验证：
    • 在终端中输入：echo $JAVA_HOME
    • 输入：java -version
    • 输入：javac -version
    • 如果显示正确路径和版本信息，则配置成功。
2.4.3 Linux 用户
  1. 确定 JDK 路径： 假设您将 JDK 解压到了 /usr/local/java/jdk-17.0.x。
  2. 编辑配置文件： 与 macOS 类似，通常是 ~/.bashrc 或 ~/.zshrc (对于个人用户) 或 /etc/profile (对于所有用户)。推荐编辑您用户目录下的配置文件。
    bash
    nano ~/.bashrc # 或 ~/.zshrc
  3. 添加或修改内容： 在文件末尾添加以下两行（将路径替换为您的实际 JDK 目录）：
    bash
    export JAVA_HOME=/usr/local/java/jdk-17.0.x
    export PATH=$JAVA_HOME/bin:$PATH
    保存并退出。
  4. 使配置生效：
    bash
    source ~/.bashrc # 或 source ~/.zshrc
  5. 验证：
    • 在终端中输入：echo $JAVA_HOME
    • 输入：java -version
    • 输入：javac -version
    • 如果显示正确路径和版本信息，则配置成功。

第三章：拥抱开发神器——Android Studio 的下载与安装

JDK 环境配置完毕后，我们就可以着手安装 Android Studio 了。

3.1 下载 Android Studio

访问 Android 开发者官网：https://developer.android.com/studio

  1. 点击页面中央的“Download Android Studio”按钮。
  2. 阅读并同意用户协议。
  3. 根据您的操作系统选择对应的下载包。
    • Windows： exe 安装程序
    • macOS： dmg 磁盘映像文件
    • Linux： tar.gz 压缩包

3.2 安装 Android Studio

3.2.1 Windows 用户
  1. 双击下载的 android-studio-xxx-windows.exe 安装包，启动安装向导。
  2. 选择组件： 确保勾选“Android Virtual Device” (AVD，即 Android 模拟器) 和 “Android SDK” (如果默认未勾选)。
  3. 安装位置： 可以使用默认路径（通常在 C:\Program Files\Android\Android Studio），也可以自定义。请记住这个路径。
  4. 开始菜单文件夹： 保持默认即可。
  5. 点击“Install”开始安装。
  6. 安装完成后，勾选“Start Android Studio”并点击“Finish”启动。
3.2.2 macOS 用户
  1. 双击下载的 android-studio-xxx.dmg 文件，会打开一个窗口。
  2. 将 Android Studio 图标拖拽到“Applications”文件夹中。
  3. 关闭 DMG 窗口，并可以将其弹出。
  4. 从“Applications”文件夹中找到 Android Studio 并双击启动。首次启动时，可能会提示“此应用来自互联网，是否确定打开？”，点击“打开”。
3.2.3 Linux 用户
  1. 将下载的 android-studio-xxx-linux.tar.gz 压缩包解压到您希望安装的位置。通常推荐解压到 /opt/ 或您的用户主目录下。
    bash
    # 例如解压到用户主目录下
    tar -zxvf /path/to/your/android-studio-xxx-linux.tar.gz -C ~/
    # 解压后会得到一个名为 android-studio 的目录
  2. 进入解压后的 android-studio/bin 目录：
    bash
    cd ~/android-studio/bin
  3. 执行脚本启动 Android Studio：
    bash
    ./studio.sh

    • 可选：创建桌面快捷方式或添加到 PATH： 启动后，Android Studio 会提示您是否创建桌面快捷方式。或者您也可以手动将 ~/android-studio/bin 添加到 PATH 环境变量中，方便直接在终端输入 studio.sh 启动。

3.3 首次启动与配置向导

无论是哪个操作系统，首次启动 Android Studio 都会进入配置向导：

  1. Import settings from a previous installation?
    • 如果您是首次安装，选择“Do not import settings”。
  2. Data Sharing: 询问是否向 Google 发送使用数据，选择您偏好的选项。
  3. Setup Wizard:
    • Installation Type: 强烈推荐选择 “Standard” (标准安装)。它会为您安装推荐的 Android SDK 组件、最新版本的 Android SDK Platform-Tools、Android SDK Build-Tools、Android Emulator 等。如果您是高级用户，才选择“Custom”来自定义组件。
    • UI Theme: 选择您喜欢的界面主题 (Light 或 Darcula)。
    • Verify Settings: 确认您的设置，会显示将要下载的组件列表和总大小。确保您的网络连接良好，并且有足够的磁盘空间。
    • Downloading Components: Android Studio 会开始下载和安装所选的 SDK 组件。这个过程可能需要较长时间，取决于您的网络速度和组件大小。请耐心等待。
    • Finish: 组件下载安装完毕后，点击“Finish”完成设置。
  4. 现在，您将看到 Android Studio 的欢迎界面，表示安装成功！

第四章：高级配置——Android SDK 与环境变量配置

虽然 Android Studio 安装过程中会自动下载和配置 SDK，但为了确保命令行工具的可用性，以及某些第三方工具的兼容性，我们强烈建议手动配置 ANDROID_HOME 和更新 Path 环境变量。

4.1 查找 Android SDK 路径

在 Android Studio 中，您可以很容易地找到 SDK 的安装路径：

  1. 在 Android Studio 欢迎界面，点击右下角的“Configure” -> “SDK Manager”。
  2. 或者在打开项目后，点击菜单栏的 File -> Settings (Windows/Linux) 或 Android Studio -> Preferences (macOS)。
  3. 在弹出的窗口中，找到 Appearance & Behavior -> System Settings -> Android SDK。
  4. “Android SDK Location” 就是您的 SDK 根目录。请记住或复制这个路径。
    • Windows 典型路径： C:\Users\YourUsername\AppData\Local\Android\sdk (AppData 是隐藏文件夹)
    • macOS 典型路径： ~/Library/Android/sdk 或 /Users/YourUsername/Library/Android/sdk
    • Linux 典型路径： ~/Android/sdk 或 /home/YourUsername/Android/sdk

4.2 配置 ANDROID_HOME 环境变量

ANDROID_HOME 环境变量指向 Android SDK 的根目录，类似于 JAVA_HOME。

4.2.1 Windows 用户
  1. 打开系统环境变量设置： (参考 2.4.1 节)
  2. 新建 ANDROID_HOME 变量：
    • 在“系统变量”区域，点击“新建…”按钮。
    • 变量名：ANDROID_HOME
    • 变量值：填写您 Android SDK 的安装路径，例如 C:\Users\YourUsername\AppData\Local\Android\sdk。
    • 点击“确定”。
  3. 编辑 Path 变量（添加 SDK 工具路径）：
    • 在“系统变量”区域，找到名为 Path 的变量，双击或点击“编辑”。
    • 点击“新建”，添加以下三个路径：
      • %ANDROID_HOME%\platform-tools (包含 adb 等重要工具)
      • %ANDROID_HOME%\tools (包含 android 命令，尽管较少使用)
      • %ANDROID_HOME%\cmdline-tools\latest\bin (新版 SDK 工具，包含 sdkmanager 等)
    • 确保这些路径的顺序无碍，一般放在 Path 变量的末尾即可。
    • 点击“确定”，直到关闭所有环境变量窗口。
  4. 验证：
    • 打开 新的 命令提示符 (CMD) 或 PowerShell 窗口。
    • 输入命令：adb version
    • 如果显示 Android Debug Bridge version 等信息，说明 platform-tools 配置成功。
    • 输入命令：sdkmanager --list
    • 如果显示 SDK 组件列表，说明 cmdline-tools 配置成功。
4.2.2 macOS / Linux 用户
  1. 确定 Android SDK 路径： (参考 4.1 节)
    例如：/Users/YourUsername/Library/Android/sdk 或 ~/Android/sdk。
  2. 编辑配置文件： 打开终端，编辑您的 Shell 配置文件 (例如 ~/.bash_profile、~/.zshrc 或 ~/.bashrc)。
    bash
    nano ~/.zshrc # 例如，如果您使用 Zsh
  3. 添加或修改内容： 在文件末尾添加以下行（将路径替换为您的实际 SDK 目录）：
    bash
    export ANDROID_HOME=/Users/YourUsername/Library/Android/sdk # 根据您的实际SDK路径修改
    export PATH=$PATH:$ANDROID_HOME/platform-tools
    export PATH=$PATH:$ANDROID_HOME/tools
    export PATH=$PATH:$ANDROID_HOME/cmdline-tools/latest/bin # 如果有此目录
    保存并退出。
  4. 使配置生效： 在终端中执行以下命令，或者重新打开一个终端窗口：
    bash
    source ~/.zshrc # 根据您的配置文件修改
  5. 验证：
    • 在终端中输入：echo $ANDROID_HOME
    • 输入：adb version
    • 输入：sdkmanager --list
    • 如果显示正确路径和版本信息，则配置成功。

第五章：优化与常见问题排查

即使严格按照上述步骤操作，有时也可能遇到一些小插曲。本章将提供一些优化建议和常见问题的解决方案。

5.1 优化 Android 模拟器 (AVD) 性能

模拟器运行缓慢是初学者常见的问题。确保您的设备启用了硬件加速虚拟化技术。

  • Intel 处理器 (Windows/Linux)：
    • 在 BIOS/UEFI 设置中启用 Intel VT-x 或 VMX。
    • 在 Android Studio 的 SDK Manager 中，确保安装了 Intel x86 Emulator Accelerator (HAXM installer)。
    • 安装 HAXM 后，需要手动运行其安装程序（通常在 SDK_LOCATION\extras\intel\Hardware_Accelerated_Execution_Manager\intelhaxm-android.exe）。
  • AMD 处理器 (Windows/Linux)：
    • 在 BIOS/UEFI 设置中启用 AMD-V 或 SVM。
    • 在 Windows 上，确保已启用 Hyper-V 功能（“控制面板” -> “程序和功能” -> “启用或关闭 Windows 功能”）。或者，如果遇到冲突，可以禁用 Hyper-V 以便 HAXM 工作，或者使用 Android Emulator Hypervisor Driver for AMD Processors。
  • macOS：
    • macOS 上的模拟器通常直接使用 Hypervisor 框架，无需额外配置 HAXM，但仍需确保 CPU 支持 VT-x。

5.2 调整 Android Studio 内存分配

默认情况下，Android Studio 可能会分配较少的内存。如果您的 RAM 充足，可以适当增加。

  1. 在 Android Studio 中，点击 File -> Settings (Windows/Linux) 或 Android Studio -> Preferences (macOS)。
  2. 导航到 Appearance & Behavior -> System Settings -> Memory Settings。
  3. 调整“IDE maximum heap size”和“Daemon maximum heap size”等选项，例如分别设置为 2048MB 或 4096MB，具体取决于您的总内存。

5.3 代理设置 (如果您的网络需要代理)

  1. 在 Android Studio 欢迎界面，点击“Configure” -> “Settings”。
  2. 导航到 Appearance & Behavior -> System Settings -> HTTP Proxy。
  3. 配置您的代理服务器信息。

5.4 常见问题与解决方案

5.4.1 “JAVA_HOME environment variable is not set.” 或 “No JDK found.”
  • 问题原因： JAVA_HOME 环境变量未正确设置，或指向的路径不正确。
  • 解决方案：
    • 仔细检查第二章中 JAVA_HOME 的配置步骤，确保路径无误。
    • 确认您打开的是 新的 命令行/终端窗口，以便环境变量生效。
    • 确认 JDK 版本与 Android Studio 兼容 (通常新版 Android Studio 支持 OpenJDK 11 或 17)。
    • 检查 JDK 路径下是否有 bin 目录，以及 bin 目录下是否有 java.exe (或 java 可执行文件)。
5.4.2 “SDK location not found.” 或 Gradle 同步失败提示 SDK 相关错误
  • 问题原因： Android Studio 未找到 SDK 目录，或 ANDROID_HOME 环境变量未正确设置。
  • 解决方案：
    • 在 Android Studio 中，通过 File -> Settings -> Android SDK 检查 SDK 路径是否正确。如果路径错误或为空，重新指定。
    • 检查第四章中 ANDROID_HOME 和 Path 环境变量的配置。
    • 确认 SDK 目录及其子目录 (platform-tools, tools, cmdline-tools) 存在且可访问。
    • 尝试在 Android Studio 的 SDK Manager 中重新下载或更新 SDK 组件。
5.4.3 模拟器无法启动或运行缓慢
  • 问题原因： 硬件虚拟化技术未启用，或驱动未正确安装。
  • 解决方案：
    • 检查 BIOS/UEFI 中是否启用了 Intel VT-x/AMD-V。
    • Windows 用户检查 HAXM (Intel) 或 Hyper-V (AMD) 是否正确安装和启用。
    • macOS 用户检查 CPU 是否支持 VT-x。
    • 确保分配给模拟器的内存和显存足够。
    • 尝试冷启动模拟器 (Wipe Data)。
5.4.4 Gradle 同步失败或编译错误
  • 问题原因： 网络问题、Gradle 缓存问题、项目依赖冲突、SDK 组件缺失。
  • 解决方案：
    • 检查网络连接，确保可以访问 Google 和 Maven 仓库。
    • 如果使用了代理，检查代理设置是否正确。
    • 在 Android Studio 菜单栏点击 File -> Invalidate Caches / Restart...，选择 Invalidate and Restart。
    • 在 Gradle 视图中点击刷新按钮（同步项目）。
    • 检查 build.gradle 文件中的依赖版本。
    • 确保所有必要的 SDK 组件都已通过 SDK Manager 下载。
5.4.5 磁盘空间不足
  • 问题原因： Android SDK、模拟器系统镜像、Gradle 缓存等文件占用大量空间。
  • 解决方案：
    • 定期清理 Gradle 缓存 (File -> Invalidate Caches / Restart...，选择 Invalidate and Restart)。
    • 在 SDK Manager 中卸载不必要的 Android SDK 版本或系统镜像。
    • 清理旧项目和日志文件。

第六章：祝贺与下一步

恭喜您！通过以上详尽的步骤，您应该已经成功安装并配置了 Android Studio 及其开发环境。现在，您已经拥有了在 Windows、macOS 或 Linux 上开发 Android 应用程序的强大工具。

下一步：

  1. 创建您的第一个 Android 项目： 在 Android Studio 欢迎界面，点击“New Project”，选择一个模板，然后按照向导完成创建。
  2. 熟悉 Android Studio 界面： 探索其各种窗口、工具栏和快捷键。
  3. 学习 Kotlin 或 Java： 这是 Android 应用开发的核心语言。
  4. 阅读官方文档： Android 开发者官网 (developer.android.com) 是您最好的学习资源。

重要提示： Android Studio 和 Android SDK 会持续更新。建议您定期通过 Android Studio 内置的更新功能 (Help -> Check for Updates) 来获取最新版本，以获得更好的功能和性能。

祝您在 Android 开发的旅程中一切顺利，创造出令人惊叹的应用程序！

发表评论

您的邮箱地址不会被公开。 必填项已用 * 标注

滚动至顶部