Android Studio无法识别SDK时,需依次通过图形界面配置SDK路径、手动创建标准SDK目录、设置系统环境变量、多维度验证及修复路径错位;每步须确保路径无中文空格、cmdline-tools结构合规、local.properties与IDE设置一致。

如果您在启动Android Studio后发现无法识别Android SDK,或新建项目时提示“SDK not found”,则很可能是SDK路径未正确配置或IDE未能自动定位。以下是解决此问题的步骤:
一、通过Android Studio图形界面配置SDK路径
该方法直接修改IDE级SDK设置,适用于首次安装或SDK路径变更后的快速修正,所有内置工具(如AVD Manager、Layout Editor)将立即生效。
1、启动Android Studio,进入欢迎界面或已打开项目后,依次点击 File → Settings(Windows/Linux)或 Android Studio → Preferences(macOS)。
2、在左侧导航栏中展开 Appearance & Behavior → System Settings,点击 Android SDK。
3、点击右上角的 Edit 按钮(铅笔图标)。
4、在弹出的SDK Setup向导中,点击 Next 后,在 SDK Location 页面点击 Browse,选择您已准备好的SDK根目录(例如:D:AndroidSdk)。
5、确保路径中不含中文、空格及特殊符号,确认后勾选所需 SDK Platforms(如 Android API 35)与 SDK Tools(必须包含 Android SDK Command-line Tools)。
6、点击 Finish,等待下载与安装完成。该操作将自动更新项目级 local.properties 文件及 .idea/misc.xml。
二、手动创建并指定SDK目录(无预装SDK时)
当Android Studio未附带SDK或需使用独立解压版SDK时,需先建立标准目录结构,再由IDE识别。此方式避免依赖安装程序,路径控制更精确。
1、在非系统盘(如D盘)新建文件夹,命名为 AndroidSdk(完整路径示例:D:AndroidSdk)。
2、前往 https://developer.android.com/studio#command-tools 下载最新版 Command line tools only 压缩包。
3、解压后,进入 cmdline-tools 文件夹,新建子目录 latest,将解压出的 bin 文件夹整体移入 latest 内。
4、将 platform-tools、tools、emulator 等必要目录按标准结构补全(可从旧SDK复制或通过sdkmanager初始化生成)。
5、返回Android Studio的 Android SDK 设置页,使用 Edit 指向该自建目录。
三、配置系统级环境变量以支持命令行工具
该步骤确保在终端(CMD/PowerShell/Terminal)中可直接调用 adb、sdkmanager、emulator 等工具,是CI/脚本化构建与命令行调试的前提。
1、新建系统环境变量:ANDROID_HOME,值设为SDK根路径(例如:D:AndroidSdk)。
2、编辑 Path 系统变量,追加以下三项(每项单独一行):
%ANDROID_HOME%platform-tools
%ANDROID_HOME% ools
%ANDROID_HOME%cmdline-toolslatestin
3、⚠️ 注意:cmdline-toolslatestin 是Android Studio 2024.2+ 强制要求的路径结构;若缺失 latest 子目录或 bin 未置于其下,sdkmanager 将无法执行。
四、验证SDK路径配置是否生效
通过多维度命令输出确认各层级SDK引用关系正确,排除缓存或路径错位导致的假性成功。
1、重启Android Studio,打开任意项目,进入 File → Project Structure → SDK Location,检查显示路径是否与实际一致。
2、打开系统终端(CMD/PowerShell/Terminal),依次执行以下命令:
adb version
sdkmanager --list | head -n 10(Windows可用 sdkmanager --list 查看前若干行)
emulator -list-avds
3、若全部命令返回有效输出(非“command not found”或“unable to access”),说明SDK路径在IDE与系统两级均已正确识别。
五、修复SDK路径错位导致的常见报错
当项目编译失败、Gradle同步异常或AVD创建失败时,常因SDK路径在多个配置点不一致引发,需逐层校准。
1、检查项目根目录下的 local.properties 文件,确认 sdk.dir 行指向正确路径(例如:sdk.dir=D:\Android\Sdk)。
2、打开 File → Project Structure → SDK Location,核对 Android SDK location 是否与 local.properties 一致。
3、检查 Build → Select Build Variant 中所选模块的 Compile SDK Version 与已安装的SDK Platform版本是否匹配(如选API 35,则必须已安装 platforms;android-35)。
4、若使用自定义AVD存储位置,还需确认系统环境变量 ANDROID_SDK_HOME 是否设置,且其值指向独立AVD目录(如 D:AndroidSdkndroidAVD)。











