记录一下我的 Gradle 开发环境配置过程(萌新扫盲)
2026/7/3 6:01:38 网站建设 项目流程

已经好久不写随笔了(虽然我的随笔并没有什么含金量),上一次写还是2025-11-10

之前写随笔写博客记录,主要是为了自己后续工作方便,遇到问题随时回来查之前写过的文章记过的笔记,同时若能帮助到别人也很高兴,现在大 AI 时代几乎没有什么是 AI 解决不了的,遇到什么问题随口一问就解决了,所以好久没有记录一些东西了

大 AI 时代的编码工具诸如 Claude Code、Codex、Open Code、Cursor IDE 等等能让很多没有编码基础的人可以完成一款程序的开发,而我这个 Java CRUD 程序员对此也很感兴趣,用自己从来没学过接触过的语言,跟 AI 聊聊天就能开发应用还是很有成就感的

我除了是一名 Java CRUD 程序员,同时还对易经占卜感兴趣(同样是个小菜鸟),所以我最近借助 AI 使用原生安卓开发了一款无常六爻排盘APP,软件名称以我朋友的名字命名,他在我六爻学习中提供了很大的帮助,感兴趣的可以去 Github 或者 Gitee 看看

而就在我开发这个应用的时候,我突然发现最难的一步居然是搭建开发环境,没想到曾经用来调侃的“精通 xxx 的安装于卸载”这一玩笑话,在今天居然真的有了含金量,所以我简单了解了一下关于 Gradle 的环境配置,并在这里做出记录,本文主要目的是扫盲,希望能帮到更多新人,文章写的很浅很啰嗦大佬见笑

回顾 Maven#

我作为 Java 程序员就站在 Java 的角度开始讲,身为 Java 开发程序员可能没用过 Gradle,但肯定用过 Maven,这里先简单回顾一下 Maven 环境是怎么搭建的

现在主流的用法都是访问 Apache Maven 官方网站,下载他们提供的编译好的二进制压缩包,解压安装到本地磁盘后,配置好JAVA_HOMEM2_HOME两个环境变量,然后编辑conf/settings.xml配置文件设置好本地 maven 仓库和国内镜像加速下载,maven 环境就搭建完成了

​编辑

​编辑

后面在项目中正常使用 mvn 命令就 OK 了,这也是大多数 Java 开发者正在使用的方法

Gradle 与 Maven 一样都是项目构建和依赖管理工具,他们应该都是一样的才对,所谓一通百通,然而我恰恰就是抱着这种思维,在后面编写安卓项目的时候被 Gradle 环境绕的稀里糊涂

Gradle 环境差异说明#

Gradle 与 Maven 其中一大不同点就是环境的搭建,大多数使用 Maven 的开发者都养成了先配好环境再去项目中使用的习惯,而 Gradle 的主流用法“倒反天罡”,他是将版本号以及 Gradle 本身的下载地址内置在项目中,当首次接手某个 Gradle 项目时会由项目主动去下载 Gradle 为你配置环境,所以我自行研究效仿 Maven 配置的 Gradle 完全用不上

​编辑

该项目只用自己配好的 Gradle,而且哪怕你本地已经部署好 Gradle,甚至版本号一致,如果不是从这个地址下载的仍然会重新触发一次下载,这是 Gradle 官方的保护策略,会基于下载地址计算 hash 值将下载好的 Gradle 用 hash 命名,所以哪怕版本一致也需要重新下载,防止因环境导致项目出现莫名奇妙的错误

​编辑

Gradle 之所以选择这种用法,除了安全稳定之外还有一个原因,就是 Gradle 每个版本之间并没有很好的兼容,他做不到像 Maven 一样全局配置后在每个项目中都能使用,如果用版本不合适的 Gradle 去执行某个项目很有可能会遇到问题

其实 Maven 也支持这种用法,虽然并没有多少人用,访问 Spring Initializr 网站选择 Maven 构建工具,在线下载一个最新版的 SpringBoot 空项目,打开它后会发现和 Gradle 十分相似项目结构

​编辑

​编辑

Maven 也支持这种 wrapper 用法,但几乎没有项目使用它,大多数人创建好项目后第一件事就是把这些用不上的文件删掉,因为 Maven 不同版本之间的兼容性非常好,可以做到全局安装一个 Maven 后运行任意一个项目而不报错

Gradle 环境搭建#

配置环境变量#

其实正常来说当使用 IDE(例如 Android Studio)创建或打开项目时会自动触发 Gradle 下载,他自己就能把环境配好,不需要手动干预就能使用,如果不在乎细节的话其实不用搭建环境,可以当它不存在直接去用就行了

只不过我是个强迫症,我不喜欢这种莫名其妙就能用的感觉,也不喜欢他往我的 C 盘里扔文件,所以我简单研究了一下环境搭建的方法,想要搭建 Gradle 环境其实非常简单,在创建、打开 Gradle 项目之前,手动在环境变量中添加GRADLE_USER_HOME环境变量就可以了,环境变量的值是期望的 Gradle 安装目录,目录下不需要有任何文件,空目录就可以了

添加好环境变量后环境就配完了,就这么简单,因为不配置环境变量的话他会默认往C盘用户目录下载文件,由于 Gradle 是打开项目后主动去下载的,所以配好环境变量后项目就会按照约定下载

Gradle 同 Maven 一样是需要下载依赖,Gradle 的依赖默认下载至安装目录下的caches/modules-2目录中,是随着 Gradle 安装目录的改变而改变,所以通常不用单独配置本地依赖仓库地址

这里有一点需要特殊说明,如果你和我一样使用 Android Studio 开发安卓项目,Android Studio 则不会使用GRADLE_USER_HOME环境变量,仍然会下载到用户目录下,所以需要自行在在 IDE 中调整一下设置

Android Studio 需要分别调整Settings设置和New Projects Setup新项目设置中,调整 Gradle 的安装目录

​编辑

​编辑

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询