必须完成android studio安装、sdk组件下载、环境变量配置三步闭环操作,缺一不可;否则新建项目会报错“cannot resolve symbol r”或无法识别adb命令。

要在Windows、macOS或Linux系统上搭建可用的Android开发环境,必须完成Android Studio安装、SDK组件下载、环境变量配置三步闭环操作,缺一不可,否则新建项目会报错“Cannot resolve symbol R”或无法识别adb命令。
下载与安装Android Studio
访问 https://developer.android.com/studio,点击【Download for Windows】(或macOS/Linux对应版本),下载官方最新稳定版(截至2026年6月为Android Studio Giraffe 2023.2.1 Patch 3)。
双击运行安装包,全程保持网络畅通——安装程序会在最后阶段自动触发SDK基础组件下载,中断会导致后续无法打开SDK Manager。
安装路径必须避开中文、空格和特殊字符,【强烈建议设为 D:\Android\Studio】,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真机调试必需)
配置系统环境变量
方法一:Windows图形化设置
右键“此电脑”→属性→高级系统设置→环境变量→系统变量中点击“新建”:
变量名:ANDROID_HOME
变量值:【D:\Android\Studio\sdk】(必须与你实际SDK路径完全一致,末尾不加反斜杠)
再在Path变量中新增两行:
%ANDROID_HOME%\platform-tools
%ANDROID_HOME%\emulator
方法二:命令行快速注入(Windows PowerShell)
以管理员身份打开PowerShell,逐行执行:
$env:ANDROID_HOME="D:\Android\Studio\sdk"
[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
配置完后,关闭所有终端窗口,重新打开CMD或Terminal,输入 adb version 验证——出现版本号即成功。
验证JDK与构建环境连通性
Android Studio 2023.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即表示构建链路打通。











