Android Studio环境变量配置说白了就是给操作系统指路，告诉它JDK、Android SDK和Gradle这些工具包具体装在哪个文件夹下，这样开发工具才能顺利被调用。 不管你是在Windows上起步，还是用Mac搞开发，这一步都绕不开，很多新手卡在这一关，其实只要理清路径，按步骤操作，几分钟就能搞定。
Android Studio环境变量配置有什么用
环境变量配置就像给开发工具链装上了导航系统，没有它，IDE可能找不到SDK，编译时直接报错；命令行里敲adb、gradle这些常用命令，系统也会回复“找不到”，配置完成后，你可以在终端里直接调用这些工具，无论是调试、打包还是运行测试，都顺畅很多，业内专家指出，环境变量配置的准确性直接影响到开发效率和项目构建的稳定性，是Android开发环境搭建中最基础也最容易出错的一环。
Windows Android Studio环境变量配置步骤
Windows系统下配置环境变量主要通过“系统属性”里的“环境变量”面板完成，操作路径清晰，跟着做就行。
配置JAVA_HOME
1. 下载并安装JDK（推荐使用LTS版本），记住安装路径，`C:\Program Files\Java\jdk-17`。
2. 右键“此电脑” → 属性 → 高级系统设置 → 环境变量。
3. 在“系统变量”区域点击“新建”，变量名填 `JAVA_HOME`，变量值填JDK的安装路径。
4. 找到 `Path` 变量，双击编辑，添加 `%JAVA_HOME%\bin`，点击确定。
5. 验证：打开命令提示符，输入 `java -version`，能看到版本信息说明成功。
配置ANDROID_HOME
1. 打开Android Studio，进入 Settings → Appearance & Behavior → System Settings → Android SDK，记下SDK路径，默认是 `C:\Users\[用户
名]\AppData\Local\Android\Sdk`。
2. 在系统变量中新建 `ANDROID_HOME`，变量值填SDK路径。
3. 编辑 `Path`，添加以下三行：
– `%ANDROID_HOME%\platform-tools`
– `%ANDROID_HOME%\tools`
– `%ANDROID_HOME%\tools\bin`
4. 验证：新开cmd，输入 `adb version`，如果显示版本号，说明配置正确。
Gradle环境变量（可选，建议配置）
虽然Android Studio内置了Gradle，但为了在命令行中直接使用gradle命令，可以配置 `GRADLE_HOME`。
1. 在Android Studio中查看Gradle使用的版本，或从官网下载Gradle解压到指定目录。
2. 新建系统变量 `GRADLE_HOME`，指向Gradle解压目录。
3. 在 `Path` 中添加 `%GRADLE_HOME%\bin`。
4. 验证：cmd输入 `gradle -version`。
验证配置是否生效
依次测试 `java -version`、`adb version`、`gradle -version`，如果都能正常输出，说明配置已经生效，如果某个命令提示找不到，重点检查路径是否写对，以及系统变量是否被正确保存。
Mac Android Studio环境变量设置方法
Mac系统通过终端编辑shell配置文件来实现，目前主流是zsh，所以主要修改 `~/.zshrc`。
配置JAVA_HOME
1. 打开终端，输入 `echo $SHELL` 确认当前shell，如果是bash，则编辑 `~/.bash_profile`。
2. 执行 `open -e ~/.zshrc` 打开配置文件（如果不存在则新建）。
3. 添加以下内容：
“`
export JAVA_HOME=/usr/libexec/java_home
export PATH=$JAVA_HOME/bin:$PATH
“`
4. 保存文件，执行 `source ~/.zshrc` 使配置立即生效。
5. 验证：终端输入 `java -version`。
配置ANDROID_HOME
1. 找到SDK路径，默认在 `~/Library/Android/sdk`。
2. 在 `~/.zshrc` 中添加：
“`
export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$ANDROID_HOME/emulator:$ANDROID_HOME/tools:$ANDROID_HOME/tools/bin:$ANDROID_HOME/platform-tools:$PATH
“`
3. 执行 `source ~/.zshrc` 刷新。
4. 验证：终端输入 `adb version`。
Gradle配置
如果使用Homebrew安装Gradle，直接 `brew install gradle` 即可，路径会自动配置，如果手动安装，在 `~/.zshrc` 中添加：
“`
export GRADLE_HOME=/usr/local/opt/gradle
export PATH=$GRADLE_HOME/bin:$PATH
“`
`source ~/.zshrc`，验证 `gradle -version`。
让配置生效
每次修改配置文件后，别忘了执行 `source ~/.zshrc`，如果不想每次都手动刷新，可以重启终端或电脑。
Android Studio环境变量配置失败原因及解决
配置失败多半是路径写错或变量没生效，下面几个场景你大概率会遇到。
“java”不是内部或外部命令
– 检查JAVA_HOME是否指向了JDK的根目录，而不是jre子目录。
– 确认Path中包含了 `%JAVA_HOME%\bin`（Windows）或 `$JAVA_HOME/bin`（Mac）。
– 如果刚配置完，需要重启cmd或终端，Windows下有时需要重启电脑。
adb命令报错，提示找不到
– 确认ANDROID_HOME路径正确，并且SDK目录下确实存在 `platform-tools` 文件夹。
– 检查Path中是否同时包含了 `%ANDROID_HOME%\platform-tools` 和 `%ANDROID_HOME%\tools`，顺序不影响但必须存在。
– 如果SDK路径包含空格，用引号包起来，但更推荐将SDK移到无空格的路径（如 `C:\Android\Sdk`）。
Gradle版本不匹配导致构建失败
– 项目根目录下的 `gradle/wrapper/gradle-wrapper.properties` 指定了所需Gradle版本，如果本地配置的Gradle版本与它不一致，构建时会自动下载，但下载失败就会报错。
– 配置GRADLE_HOME是为了在命令行中全局使用gradle，与项目构建无关，但建议统一版本。
系统变量与用户变量混淆
– 在Windows上，如果同时配置了用户变量和系统变量，系统变量的优先级更高，建议只在系统变量中配置，避免混乱。
– Mac上则没有这个区分，配置文件里按顺序加载，注意不要重复定义。
环境变量配置Q&A
Android Studio环境变量配置后需要重启电脑吗？
Windows下配置系统变量后，通常需要重启IDE（如Android Studio），新开的cmd窗口会立即生效，但旧窗口不会，如果配置后IDE仍然找不到路径，重启电脑是最稳妥的方法，Mac下执行 `source` 后立即生效，但IDE可能需要重启以加载新环境变量。
配置了ANDROID_HOME但adb还是报错？
先确认 `platform-tools` 目录是否存在于SDK路径下，很多情况是SDK没下载完整，打开Android Studio的SDK Manager，确保“Android SDK Platform-Tools”已安装，Path变量中是否写入了正确的目录，注意Windows下路径分隔符用反斜杠，Mac下用正斜杠，行业共识认为，90%的配置失败都源于路径书写错误或环境变量未刷新。
环境变量配置对项目构建速度有影响吗？
没有直接影响，但配置错误会导致构建中断，反复查找错误反而浪费时间，正确的环境变量能保证开发工具链稳定运行，让构建过程一气呵成，据统计，因环境变量配置不当导致的项目构建失败，在初学者中占相当比例，所以花几分钟把这一步做扎实，后续开发会更省心。
写在最后
环境变量配置看似基础，却是决定开发体验的关键，按照本文的步骤，先确认路径，再逐条添加变量，最后验证结果，整个过程不会超过十分钟，配置完成后，你就能在终端中自由调用各种工具，Android开发之路也会更加顺畅。