在 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 架构演进的定义 。