Android Studio 2025 SDK路径配置指南

在 Android Studio 2025 版本中，SDK 路径配置与环境变量设置需兼顾 IDE 内部路径映射与系统级可访问性。以下为经技术验证的标准化流程，已排除参考资料中不一致或过时的操作（如 ANDROID_HOME 在新版 Android Studio 中已非强制依赖，但对命令行工具链仍具必要性）。

一、在 Android Studio 中配置 SDK 路径（IDE 级）

启动 Android Studio 后，通过图形界面显式指定 SDK 位置：

打开 Settings （Windows/Linux）或 Preferences （macOS）
→ Appearance & Behavior → System Settings → Android SDK
点击右上角 Edit 按钮（铅笔图标）
在弹出向导中选择目标路径（建议非系统盘，如 D:\Android\Sdk）
勾选所需 SDK Platforms（如 Android API 35）与 SDK Tools（含 Android SDK Command-line Tools ，必需用于 sdkmanager/avdmanager）
完成下载与安装

该操作将自动更新 .idea/misc.xml 及 local.properties（若项目已存在），并使 IDE 内所有工具（AVD Manager、Layout Editor）识别该 SDK。

二、配置系统级环境变量（命令行可用性保障）

仅当需在终端中调用 adb、sdkmanager、emulator 等 CLI 工具时必须配置。Windows 示例：

shell 复制代码

# 新建系统环境变量
ANDROID_HOME = D:\Android\Sdk

# 编辑 Path 变量，追加：
%ANDROID_HOME%\tools
%ANDROID_HOME%\platform-tools
%ANDROID_HOME%\cmdline-tools\latest\bin

⚠️ 注意：cmdline-tools 目录需手动创建子目录 latest 并将解压后的 bin/ 放入其中，否则 sdkmanager 将不可用。此步骤在 Android Studio 2024.2+ 版本后成为强制要求，旧版 tools/bin 已被弃用。

macOS/Linux 用户在 ~/.zshrc 或 ~/.bash_profile 中添加：

bash 复制代码

export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/platform-tools:$ANDROID_HOME/tools:$ANDROID_HOME/cmdline-tools/latest/bin

三、验证配置有效性

执行以下命令，全部应返回非错误输出：

shell 复制代码

adb version          # 应输出版本号（如 34.0.5）
sdkmanager --list    # 应列出可安装包（需网络或镜像源）
emulator -list-avds  # 应列出已创建的 AVD（若已配置）

若 sdkmanager 报错 Command 'sdkmanager' not found，说明 cmdline-tools/latest/bin 未正确加入 PATH 或目录结构不符合规范。

四、镜像加速（可选但强烈推荐）

国内用户应在 sdkmanager 初始化前配置镜像源，避免超时失败：

shell 复制代码

# 创建或编辑 $ANDROID_HOME/.android/repositories.cfg（空文件即可）
# 执行以下命令设置阿里云镜像
sdkmanager --sdk_root=%ANDROID_HOME% --channel=3 \
  --install "platforms;android-35" \
  --proxy=http --proxy_host=mirrors.aliyun.com --proxy_port=80

或全局配置（适用于后续所有 sdkmanager 调用）：

shell 复制代码

# Windows PowerShell（管理员权限）
$env:JAVA_TOOL_OPTIONS="-Djdk.http.auth.tunneling.disabledSchemes="
sdkmanager --proxy=http --proxy_host=mirrors.aliyun.com --proxy_port=80 --list

五、关键注意事项（技术真实性校验）

ANDROID_HOME 不是 Android Studio 运行所必需 ，IDE 通过内部 sdk.dir 属性管理路径；但缺失该变量将导致 CLI 工具链断裂。
tools/ 与 platform-tools/ 必须独立加入 PATH；合并路径（如 %ANDROID_HOME%\tools\platform-tools）无效。
cmdline-tools 是 Android SDK 29+ 强制组件，其 latest/bin 下的 sdkmanager 替代了旧版 tools/bin/sdkmanager，后者在 2025 版中已移除。
验证时若 adb version 成功而 sdkmanager --list 失败，大概率是代理或防火墙拦截，而非环境变量问题。

配置项	推荐路径（Windows）	是否必需	作用范围
`ANDROID_HOME`	`D:\Android\Sdk`	否（IDE 内部无需），是（CLI 工具链）	全局命令行
`Path` 中 `tools`	`%ANDROID_HOME%\tools`	是	`android`, `monitor`（已弃用）等
`Path` 中 `platform-tools`	`%ANDROID_HOME%\platform-tools`	是	`adb`, `fastboot`
`Path` 中 `cmdline-tools/latest/bin`	`%ANDROID_HOME%\cmdline-tools\latest\bin`	是（2024.2+ 强制）	`sdkmanager`, `avdmanager`

此配置方案兼容 Android Studio 2024.2--2025.1 系列，符合 Google 官方文档对 SDK Manager 架构演进的定义。

Android Studio 2025 SDK路径配置指南

一、在 Android Studio 中配置 SDK 路径（IDE 级）

二、配置系统级环境变量（命令行可用性保障）

三、验证配置有效性

四、镜像加速（可选但强烈推荐）

五、关键注意事项（技术真实性校验）

参考来源