Ubuntu安装配置JDK与Maven：开发环境搭建

帮助文档
Ubuntu安装配置JDK与Maven：开发环境搭建
来源：www.jcwlyf.com浏览：29更新：2026-01-11
在进行Java开发时，JDK（Java Development Kit）和Maven是必不可少的工具。JDK提供了Java程序开发所需的环境和工具，而Maven则是一个强大的项目管理和构建工具，能够帮助我们更高效地管理项目依赖和构建项目。本文将详细介绍在Ubuntu系统上安装和配置JDK与Maven的步骤，帮助你快速搭建起Java开发环境。
一、安装JDK
在Ubuntu系统上安装JDK有多种方式，下面分别介绍通过包管理器和手动下载安装的方法。
1. 通过包管理器安装
Ubuntu的包管理器可以方便地安装JDK，以下是具体步骤：
首先，更新系统的软件包列表，打开终端，输入以下命令：
```
sudo apt update
```
然后，查看可用的JDK版本，输入以下命令：
```
sudo apt search openjdk
```
选择你需要的JDK版本进行安装，例如安装OpenJDK 11，输入以下命令：
```
sudo apt install openjdk-11-jdk
```
安装完成后，验证JDK是否安装成功，输入以下命令查看Java版本：
```
java -version
```
如果显示出Java的版本信息，说明JDK安装成功。
2. 手动下载安装
如果你需要特定版本的JDK，也可以手动下载安装，以下是具体步骤：
第一步，访问Oracle官方网站或OpenJDK官方网站，下载适合你系统的JDK压缩包。
第二步，将下载的压缩包解压到指定目录，例如解压到 /opt 目录下，打开终端，输入以下命令：
```
sudo tar -zxvf jdk-xx.tar.gz -C /opt
```
其中，jdk-xx.tar.gz 是你下载的JDK压缩包文件名。
第三步，配置环境变量。打开终端，编辑 ~/.bashrc 文件，输入以下命令：
```
nano ~/.bashrc
```
在文件末尾添加以下内容：
```
export JAVA_HOME=/opt/jdk-xx
export PATH=$JAVA_HOME/bin:$PATH
export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar
```
其中，jdk-xx 是你解压后的JDK目录名。
保存并退出文件，然后使配置生效，输入以下命令：
```
source ~/.bashrc
```
最后，验证JDK是否安装成功，输入以下命令查看Java版本：
```
java -version
```
二、安装Maven
同样，在Ubuntu系统上安装Maven也有多种方式，下面分别介绍通过包管理器和手动下载安装的方法。
1. 通过包管理器安装
使用Ubuntu的包管理器安装Maven非常简单，以下是具体步骤：
首先，更新系统的软件包列表，打开终端，输入以下命令：
```
sudo apt update
```
然后，安装Maven，输入以下命令：
```
sudo apt install maven
```
安装完成后，验证Maven是否安装成功，输入以下命令查看Maven版本：
```
mvn -version
```
如果显示出Maven的版本信息，说明Maven安装成功。
2. 手动下载安装
如果你需要特定版本的Maven，也可以手动下载安装，以下是具体步骤：
第一步，访问Maven官方网站，下载适合你系统的Maven压缩包。
第二步，将下载的压缩包解压到指定目录，例如解压到 /opt 目录下，打开终端，输入以下命令：
```
sudo tar -zxvf apache-maven-xx.tar.gz -C /opt
```
其中，apache-maven-xx.tar.gz 是你下载的Maven压缩包文件名。
第三步，配置环境变量。打开终端，编辑 ~/.bashrc 文件，输入以下命令：
```
nano ~/.bashrc
```
在文件末尾添加以下内容：
```
export MAVEN_HOME=/opt/apache-maven-xx
export PATH=$MAVEN_HOME/bin:$PATH
```
其中，apache-maven-xx 是你解压后的Maven目录名。
保存并退出文件，然后使配置生效，输入以下命令：
```
source ~/.bashrc
```
最后，验证Maven是否安装成功，输入以下命令查看Maven版本：
```
mvn -version
```
三、配置Maven
安装完Maven后，还需要进行一些配置，以满足项目的需求。
1. 配置本地仓库
Maven默认的本地仓库位于 ~/.m2/repository 目录下，你可以根据需要修改本地仓库的位置。打开Maven的配置文件 settings.xml，该文件位于 $MAVEN_HOME/conf 目录下，输入以下命令：
```
nano $MAVEN_HOME/conf/settings.xml
```
找到 <localRepository> 标签，将其值修改为你想要的本地仓库路径，例如：
```
<localRepository>/home/user/maven-repo</localRepository>
```
保存并退出文件。
2. 配置镜像源
为了加快依赖下载速度，可以配置Maven的镜像源。在 settings.xml 文件中找到 <mirrors> 标签，添加以下内容：
```
<mirror>
    <id>aliyunmaven</id>
    <mirrorOf>*</mirrorOf>
    <name>阿里云公共仓库</name>
    <url>https://maven.aliyun.com/repository/public</url>
</mirror>
```
保存并退出文件。
四、测试开发环境
安装和配置好JDK与Maven后，我们可以创建一个简单的Maven项目来测试开发环境是否正常工作。
打开终端，输入以下命令创建一个Maven项目：
```
mvn archetype:generate -DgroupId=com.example -DartifactId=my-project -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false
```
该命令会创建一个名为 my-project 的Maven项目。进入项目目录，输入以下命令编译和运行项目：
```
cd my-project
mvn compile
mvn exec:java -Dexec.mainClass="com.example.App"
```
如果项目能够正常编译和运行，说明JDK与Maven开发环境搭建成功。
五、常见问题及解决方法
在安装和配置JDK与Maven的过程中，可能会遇到一些问题，下面介绍一些常见问题及解决方法。
1. Java命令找不到
如果输入 java -version 命令时提示“命令未找到”，可能是环境变量配置不正确。检查 ~/.bashrc 文件中 JAVA_HOME 和 PATH 变量的配置是否正确，然后使配置生效：
```
source ~/.bashrc
```
2. Maven命令找不到
如果输入 mvn -version 命令时提示“命令未找到”，可能是环境变量配置不正确。检查 ~/.bashrc 文件中 MAVEN_HOME 和 PATH 变量的配置是否正确，然后使配置生效：
```
source ~/.bashrc
```
3. 依赖下载失败
如果在Maven项目中下载依赖时失败，可能是镜像源配置不正确或网络问题。检查 settings.xml 文件中镜像源的配置是否正确，或者尝试更换其他镜像源。
通过以上步骤，你可以在Ubuntu系统上成功安装和配置JDK与Maven，搭建起一个完整的Java开发环境。希望本文对你有所帮助。