已经好久不写随笔了虽然我的随笔并没有什么含金量上一次写还是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_HOME和M2_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 的安装目录​编辑​编辑