Android Studio下载安装与环境配置完整教程

作者:技术拾光时间:2026-06-05 11:18:12浏览:303

AndroidStudio安装需完成三步:下载安装程序、通过SDKManager获取API和工具组件、配置ANDROID_HOME及Path环境变量。全程保持网络畅通,安装路径避免中文,管理员身份运行可避免权限问题。验证adbversion及Gradle构建成功即环境就绪。

想在电脑上搭建一套可用的Android开发环境?别急,先完成以下三个关键步骤:安装Android Studio、下载SDK组件、配置环境变量。每一步环环相扣,缺一不可——否则新建项目时会遇到“Cannot resolve symbol R”报错或adb命令找不到的问题。下面直接提供操作指南。

Android Studio下载安装与环境配置完整教程

Android Studio下载与安装步骤

首先访问官方站点 https://developer.android.com/studio,点击对应操作系统的下载按钮(Windows/macOS/Linux)。截至2026年6月,稳定版本为Android Studio Giraffe 2024.2.1 Patch 3。

安装时需注意两点:第一,全程保持网络畅通——安装程序会在最后阶段自动拉取SDK基础组件,中途断网可能导致后续SDK Manager无法打开;第二,安装路径不能包含中文、空格或特殊字符,推荐设置为 D:AndroidStudio,因为C盘默认路径在Win11下易因权限问题导致SDK写入失败。

组件选择页面请勾选“Android SDK”和“Android Virtual Device”,其余保持默认即可,一路Next完成安装。

首次启动与SDK核心组件下载

安装完成后,建议以管理员身份运行Android Studio(Windows右键→“以管理员身份运行”),否则后续SDK Tools安装时可能被系统拦截。

在欢迎界面点击Configure → SDK Manager,进入管理面板。在SDK Platforms标签页中,至少勾选两个API级别:
① 最新稳定版(例如Android 15 API 35)
② 兼容主力机型的旧版(例如Android 12L API 32)
如果只勾选一个,编译时可能找不到support库或出现targetSdkVersion校验失败。

然后切换到SDK Tools标签页,勾选以下四项并确认安装:
Android SDK Build-Tools(选择最新稳定版,如34.0.0)
Android SDK Platform-Tools(包含adb、fastboot)
Android Emulator(如需在模拟器上测试)
Google USB Driver(Windows真机调试必选)

Android环境变量配置教程

这一步容易出错,实际只需选用以下两种方法之一即可。

方法一:Windows图形化设置
右键“此电脑”→属性→高级系统设置→环境变量→在系统变量中点击“新建”:
变量名:ANDROID_HOME
变量值:D:AndroidStudiosdk(必须与实际SDK路径完全一致,末尾不加反斜杠)
然后找到Path变量,新增两行:
%ANDROID_HOME%platform-tools
%ANDROID_HOME%emulator

方法二:命令行快速注入(Windows PowerShell)
以管理员身份打开PowerShell,逐行执行:
$env:ANDROID_HOME="D:AndroidStudiosdk"
[System.Environment]::SetEnvironmentVariable('ANDROID_HOME', $env:ANDROID_HOME, 'Machine')
[System.Environment]::SetEnvironmentVariable('Path', $env:Path + ';%ANDROID_HOME%platform-tools;%ANDROID_HOME%emulator', 'Machine')

如果是macOS/Linux用户,编辑 ~/.zshrc(macOS Catalina及以后)或 ~/.bashrc(旧版),追加:
export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/platform-tools:$ANDROID_HOME/emulator

配置完成后,关闭所有终端窗口重新打开,输入 adb version 验证——出现版本号即表示环境变量生效。

验证JDK与构建环境连通性

Android Studio 2024.2+ 已内置OpenJDK 17,理论上无需单独安装JDK。但如果系统PATH中存在旧版JDK(如JDK 8),Gradle同步会失败。

在Android Studio中依次点击 File → Project Structure → SDK Location,确认JDK location指向 bundled JDK(路径中包含 jbr 或 jdk-17)。

最后新建一个Empty Activity项目,等待Gradle同步完成且无红色波浪线;然后在Terminal中执行 ./gradlew build,看到 BUILD SUCCESSFUL 即表示整个Android开发环境搭建完毕。