Android SDK环境变量配置需先设置ANDROID_HOME指向SDK根目录,再将platform-tools、tools和cmdline-tools/latest/bin加入PATH,最后通过adb version等命令验证。
android sdk环境变量配置,核心是让系统在任意终端中都能识别并调用 adb、sdkmanager、emulator 等命令。它不依赖 android studio 图形界面,而是为命令行工具链提供“全局可达性”。配置分两步:定义 sdk 根目录(android_home) 和 把关键子目录加进系统 path。
设置 ANDROID_HOME 环境变量
这是指向你 Android SDK 安装根目录的“主钥匙”,所有工具路径都基于它推导。
-
Windows:
- 右键“此电脑” → “属性” → “高级系统设置” → “环境变量”
- 在“系统变量”区域点击“新建”
- 变量名填
ANDROID_HOME,变量值填你的 SDK 路径,例如:D:\Android\Sdk或C:\Users\张三\AppData\Local\Android\Sdk
-
macOS / Linux:
- 编辑 shell 配置文件(如
~/.zshrc或~/.bash_profile) - 添加一行:
export ANDROID_HOME=$HOME/Library/Android/sdk(macOS 默认路径)
或export ANDROID_HOME=$HOME/android-sdk(若你自定义解压在此)
- 编辑 shell 配置文件(如
✅ 提示:路径必须准确指向包含
platforms/、platform-tools/、tools/、cmdline-tools/四个文件夹的根目录。
把 SDK 工具目录加入 PATH
PATH 决定了系统在哪找可执行文件。需添加以下三个路径(顺序不敏感,但建议按常用度排列):
%ANDROID_HOME%\platform-tools(含adb、fastboot)%ANDROID_HOME%\tools(含sdkmanager旧版入口、avdmanager)%ANDROID_HOME%\cmdline-tools\latest\bin(新版sdkmanager必须项,不能省略)-
Windows 示例(在 Path 变量中新增三行):
%ANDROID_HOME%\platform-tools %ANDROID_HOME%\tools %ANDROID_HOME%\cmdline-tools\latest\bin
⚠️ 注意:
cmdline-tools\latest\bin必须存在——如果解压后只有cmdline-tools\bin,需手动创建latest文件夹,并把bin移入其中。 -
macOS / Linux 示例(追加到
~/.zshrc):export PATH=$PATH:$ANDROID_HOME/platform-tools:$ANDROID_HOME/tools:$ANDROID_HOME/cmdline-tools/latest/bin
保存后运行
source ~/.zshrc生效。
验证是否成功
打开新终端(重要:旧终端不会自动加载新变量),依次执行:
-
echo $ANDROID_HOME(macOS/Linux)或echo %ANDROID_HOME%(Windows)→ 应输出你设的路径 -
adb version→ 显示类似Android Debug Bridge version 34.0.5 -
sdkmanager --list | head -n 5→ 能列出包名(需联网或已配镜像) -
emulator -list-avds→ 显示已建模拟器(若有)
任一命令报 command not found,优先检查 cmdline-tools/latest/bin 是否在 PATH 中、目录结构是否合规。
不复杂但容易忽略


















