Gradle安装配置教程(Linux通用版)
本文最后更新于:2025年4月13日
有需要安装Linux系统的小伙伴,可以点击下面任意一个链接查看安装教程:
CentOS | Ubuntu | Debian | |
---|---|---|---|
安装教程 | 点我查看 | 点我查看 | 点我查看 |
一、安装前检查(Linux端)
1. 检查电脑上是否安装JDK,如果没有安装,请查看JDK安装教程:点我查看
2. 已经安装JDK的小伙伴,请在命令行执行如下命令,如果出现下图的版本信息,就说明JDK环境变量配置成功:
1 |
|
3. 检查Ubuntu发行版本信息,执行如下命令:
1 |
|
二、下载Gradle安装包(Windows端)
1. 点击右侧链接打开官网页面:https://gradle.org/releases/
如果你使用的SpringBoot项目,建议使用6.8及以上的版本。
2. 这里我选择8.0.2版本下载。点击complete下载:
三、安装并配置Gradle环境变量
1. 将前面下载好的Gradle安装包使用SFTP工具(这里我使用的是Eleterm)由Windows端传输到Linux端(请先确保Windows本身已经通过SSH方式连接到Linux):
2. 在左侧Windows端找到下载好的安装包:
3. 在右侧Linux端设置安装包存放路径,这里我将安装包存放在/opt
下:
4. 按照下图所示操作,将Maven安装包传到Linux端的/opt
目录下:
5. 等待一段时间后,此时Linux端的/opt
目录下已经存放了刚才我们传输的文件:
6. 此时我们切换回命令行,执行如下命令切换到/opt
目录下:
1 |
|
7. 在Linux端下载安装unzip(解压缩工具):
- Ubuntu/Debian
1 |
|
- CentOS
1 |
|
7. 解压刚刚传输过来的安装包,执行如下命令:
小技巧:在命令行中输入文件名时,我们可以只写文件的前一部分,然后按一下Tab键补齐文件名。
1 |
|
8. 等待一段时间后,解压完成,执行如下命令,进入解压后的文件夹名称:
使用cd
命令进入解压后的文件夹:
1 |
|
9. 安装vim编辑器,根据自己的操作系统执行如下命令来安装:
- CentOS
1 |
|
- Ubuntu/Debian
1 |
|
10. 在/etc/profile.d
目录下创建gradle_env.sh
文件,执行如下命令:
1 |
|
11. 复制如下代码
1 |
|
12. 按i键进入编辑模式,按Shift和Insert键粘贴第十步的代码,效果如下图所示:
13. 完成后按一下Esc键,然后输入:wq
保存并退出。
14. 输入如下命令,查看当前文件路径,选中这个路径并复制:
1 |
|
15. 再次打开gradle_env.sh
文件:
1 |
|
16. 将光标移动到第2行,按i进入编辑模式,将GRADLE_HOME
对应的值替换成第14步复制的路径,按Shift和Insert键粘贴,最终效果如下图:
17. 完成后按一下Esc键,然后输入:wq
保存并退出。
18. 执行如下命令,让环境变量配置生效:
1 |
|
19. 执行如下命令可以查看Gradle版本,如果出现如下提示信息,说明Gradle环境变量配置成功:
1 |
|
四、配置Gradle下载源
由于Gradle自带Maven下载源是国外的,在后续下载依赖的过程中会比较慢。这里我们需要将下载源换成国内镜像。
1. 找一个你熟悉的位置存放Gradle依赖,这里我创建一个目录专门存放Gradle依赖:
1 |
|
2. 进入Gradle安装目录,执行如下命令:
1 |
|
3. 执行如下命令,查看当前目录下的所有文件和文件夹:
1 |
|
4. 执行如下命令,查看当前目录下的所有文件和文件夹:
5. 进入init.d
文件夹,执行如下命令:
1 |
|
6. 执行ls
命令,我们发现这个目录下有一个readme.txt
文件。执行cat readme.txt
命令可以查看文件内容:
1 |
|
简单翻译一下就是在init.d
目录下创建一个初始化文件,这里我们需要新建一个init.gradle
文件。
3. 新建一个init.gradle
文件,执行如下命令:
1 |
|
4. 复制如下代码:
1 |
|
5. 按i键进入编辑模式,按Shift和Insert键粘贴第十步的代码,效果如下图所示:
6. 完成后按一下Esc键,然后输入:wq
保存并退出。至此,Gradle下载源配置完成。