Android Gradle下载后本地使用教程 (macOS/Windows通用)

Gradle是Android开发中不可或缺的构建工具，但每次创建项目都从网络下载不仅耗时，还可能因网络问题失败。本文将教你如何在macOS和Windows系统下，将Gradle下载到本地并配置使用，实现Gradle离线使用，提升开发效率。

1. 下载Gradle分发版

访问Gradle官网 https://gradle.org/releases/，选择你需要的版本（建议选择最新稳定版）。注意下载binary-only或complete包，前者仅包含二进制文件，后者包含源码和文档。对于Android构建系统开发，binary-only已足够。

2. 解压并放置到合适目录

下载的ZIP文件解压后，建议统一管理：

• macOS: 解压到 /Users/你的用户名/gradle 或 /usr/local/gradle
• Windows: 解压到 C:\gradle 或 D: ools\gradle，避免路径包含空格

3. 配置环境变量（关键步骤）

Gradle环境变量配置是让系统识别gradle命令的关键。

macOS:

# 打开终端，编辑配置文件（根据使用的shell选择）nano ~/.bash_profile   # 或 ~/.zshrc# 添加以下内容export GRADLE_HOME=/Users/你的用户名/gradle/gradle-8.5export PATH=$PATH:$GRADLE_HOME/bin# 保存后执行source ~/.bash_profile    

Windows:

# 打开“系统属性” -> “环境变量”# 新建系统变量 GRADLE_HOME，值为解压路径，如 C:\gradle\gradle-8.5# 编辑 Path 变量，添加 %GRADLE_HOME%�in# 确定保存    

4. 验证安装

打开终端（或命令提示符），输入 gradle -v，如果显示Gradle版本信息，则配置成功。

5. 在Android Studio中配置本地Gradle分发

打开Android Studio，依次进入 File > Settings (macOS下为 Preferences) > Build, Execution, Deployment > Build Tools > Gradle。在右侧的“Gradle user home”可以保持默认，重点在“Use Gradle from”选项，选择“Specified location”，然后填入你的Gradle解压路径（即GRADLE_HOME的路径）。点击Apply并OK。之后新建项目就会使用本地Gradle，无需重复下载，实现本地Gradle分发。

6. 常见问题与解决

• 权限问题：macOS下如果遇到权限不足，可执行 chmod +x $GRADLE_HOME/bin/gradle
• 路径错误：检查环境变量是否配置正确，终端重启后是否生效
• 版本不匹配：项目所需的Gradle版本可能与本地版本不一致，建议项目中使用与本地相同的版本，或继续允许下载特定版本

通过以上步骤，你已经成功配置了Gradle本地使用环境，无论是macOS还是Windows，都能显著加快Android项目构建速度，减少网络等待。享受高效的开发吧！