Gradle安装配置教程(Linux通用版)

本文最后更新于:2025年4月13日

有需要安装Linux系统的小伙伴,可以点击下面任意一个链接查看安装教程:

CentOS Ubuntu Debian
安装教程 点我查看 点我查看 点我查看

一、安装前检查(Linux端)

1. 检查电脑上是否安装JDK,如果没有安装,请查看JDK安装教程:点我查看

2. 已经安装JDK的小伙伴,请在命令行执行如下命令,如果出现下图的版本信息,就说明JDK环境变量配置成功:

1
java -version

3. 检查Ubuntu发行版本信息,执行如下命令:

1
uname -a

二、下载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
cd /opt

7. 在Linux端下载安装unzip(解压缩工具):

  • Ubuntu/Debian
1
sudo apt -y install unzip
  • CentOS
1
sudo yum -y install unzip

7. 解压刚刚传输过来的安装包,执行如下命令:

小技巧:在命令行中输入文件名时,我们可以只写文件的前一部分,然后按一下Tab键补齐文件名。

1
unzip gradle-8.0.2-all.zip

8. 等待一段时间后,解压完成,执行如下命令,进入解压后的文件夹名称:

使用cd命令进入解压后的文件夹:

1
cd gradle-8.0.2

9. 安装vim编辑器,根据自己的操作系统执行如下命令来安装:

  • CentOS
1
sudo yum -y install vim
  • Ubuntu/Debian
1
sudo apt -y install vim

10. 在/etc/profile.d目录下创建gradle_env.sh文件,执行如下命令:

1
vim /etc/profile.d/gradle_env.sh

11. 复制如下代码

1
2
3
4
#GRADLE_HOME  
GRADLE_HOME=
PATH=$PATH:$GRADLE_HOME/bin
export PATH GRADLE_HOME

12. 按i键进入编辑模式,按ShiftInsert键粘贴第十步的代码,效果如下图所示:

13. 完成后按一下Esc键,然后输入:wq保存并退出。

14. 输入如下命令,查看当前文件路径,选中这个路径并复制:

1
pwd

15. 再次打开gradle_env.sh文件:

1
vim /etc/profile.d/gradle_env.sh

16. 将光标移动到第2行,按i进入编辑模式,将GRADLE_HOME对应的值替换成第14步复制的路径,按ShiftInsert键粘贴,最终效果如下图:

17. 完成后按一下Esc键,然后输入:wq保存并退出。

18. 执行如下命令,让环境变量配置生效:

1
source /etc/profile.d/gradle_env.sh

19. 执行如下命令可以查看Gradle版本,如果出现如下提示信息,说明Gradle环境变量配置成功:

1
gradle -v

四、配置Gradle下载源

由于Gradle自带Maven下载源是国外的,在后续下载依赖的过程中会比较慢。这里我们需要将下载源换成国内镜像。

1. 找一个你熟悉的位置存放Gradle依赖,这里我创建一个目录专门存放Gradle依赖:

1
mkdir -p /home/gradle/repository

2. 进入Gradle安装目录,执行如下命令:

1
cd /opt/gradle-8.0.2

3. 执行如下命令,查看当前目录下的所有文件和文件夹:

1
ls

4. 执行如下命令,查看当前目录下的所有文件和文件夹:

5. 进入init.d文件夹,执行如下命令:

1
cd init.d/

6. 执行ls命令,我们发现这个目录下有一个readme.txt文件。执行cat readme.txt命令可以查看文件内容:

1
You can add .gradle (e.g. test.gradle) init scripts to this directory. Each one is executed at the start of the build.

简单翻译一下就是在init.d目录下创建一个初始化文件,这里我们需要新建一个init.gradle文件。

3. 新建一个init.gradle文件,执行如下命令:

1
vim init.gradle

4. 复制如下代码:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
allprojects {
repositories {
mavenLocal()
maven { name "Alibaba" ; url "https://maven.aliyun.com/repository/public" }
maven { name "Bstek" ; url "https://nexus.bsdn.org/content/groups/public/" }
mavenCentral()
}
buildscript {
repositories {
maven { name "Alibaba" ; url 'https://maven.aliyun.com/repository/public' }
maven { name "Bstek" ; url 'https://nexus.bsdn.org/content/groups/public/' }
maven { name "M2" ; url 'https://plugins.gradle.org/m2/' }
}
}
}

5. 按i键进入编辑模式,按ShiftInsert键粘贴第十步的代码,效果如下图所示:

6. 完成后按一下Esc键,然后输入:wq保存并退出。至此,Gradle下载源配置完成。


Gradle安装配置教程(Linux通用版)
https://www.icode504.com/posts/57.html
作者
iCode504
发布于
2025年4月13日
许可协议