Java项目Ubuntu编译打包步骤

首页

编程语言

Java项目Ubuntu编译打包步骤

热心网友

转载

2026-04-26

Ubuntu下Ja va项目编译与打包步骤

Ja va项目Ubuntu编译打包步骤

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

在Ubuntu环境下搞定Ja va项目的编译和打包，其实没那么复杂。关键在于把环境搭对，然后根据你的项目特点，选对工具和方法。下面这份手把手的指南，涵盖了从基础环境配置到进阶打包方案的全过程，帮你避开那些常见的坑。

一准备环境

万事开头难，但环境配置这一步，只要按顺序来，其实很简单。核心就两件事：装好JDK，再选一个趁手的构建工具。

安装 JDK（建议 OpenJDK 11 或更高版本）：
- 打开终端，一条命令就能搞定安装：sudo apt update && sudo apt install openjdk-11-jdk。这条命令会先更新软件包列表，然后安装指定版本的JDK。
- 装完之后，别忘了验证一下。分别输入ja va -version和ja vac -version，看看输出的版本号是不是你刚装的。这一步能帮你确认环境变量是否配置正确。
安装构建工具（二选一或都装）：
- Ma ven：如果你习惯用Ma ven，安装命令是sudo apt install ma ven。验证安装成功同样用版本命令：mvn -v。
- Gradle：喜欢Gradle的灵活性？那就用sudo apt install gradle来安装。安装后执行gradle -v进行验证。
环境齐备后，建议准备一个有入口类的项目结构来测试。最快捷的方式是使用Ma ven原型生成一个简单项目：mvn archetype:generate -DgroupId=com.example -DartifactId=my-app -DarchetypeArtifactId=ma ven-archetype-quickstart -DinteractiveMode=false。这个命令会在当前目录生成一个标准的Ma ven项目骨架，里面自带一个可执行的示例主类。

二使用Ma ven打包

对于Ma ven项目，打包过程已经高度标准化。你只需要在包含pom.xml文件的根目录下操作。

执行核心打包命令：mvn clean package。这个命令会先清理旧的构建产物，然后执行编译、测试，最终打包。
- 打包生成的JAR文件默认位于target/目录下，名字通常是项目名-版本号.jar。
- 不过，默认打出来的JAR可能不可直接运行。这就需要一些常用插件与配置来增强：
  - 编译器插件：用于指定Ja va源码和目标字节码的版本，确保兼容性。
```
  org.apache.ma ven.plugins
  ma ven-compiler-plugin
  3.8.1
  
    11
    11
  
```
  - 可执行 JAR：使用ma ven-jar-plugin在清单文件中指定主类，这样打出来的JAR才能用ja va -jar运行。
```
  org.apache.ma ven.plugins
  ma ven-jar-plugin
  3.2.0
  
    
      
        true
        lib/
        com.example.App
      
    
  
```
  - 依赖外置：把项目依赖的第三方库单独复制到target/lib目录，可以让主JAR包体积更小，更新更灵活。这需要配合上面manifest中设置的classpathPrefix=lib/使用。
```
  org.apache.ma ven.plugins
  ma ven-dependency-plugin
  3.2.0
  
    
      copy-dependencies
      package
      
        copy-dependencies
      
      
        ${project.build.directory}/lib
      
    
  
```
配置妥当后，再次运行mvn clean package，就能在target/下得到可执行的JAR。运行它只需：ja va -jar target/你的项目名.jar。

三使用Gradle打包

Gradle的打包逻辑同样清晰，其配置写在build.gradle文件中，风格更偏向脚本化。

在项目根目录执行构建命令：./gradlew clean build（如果系统已全局安装Gradle，也可用gradle clean build）。

打包产物位于build/libs/目录下。

要让JAR可执行，需要在build.gradle中进行一些基本配置：

plugins {
    id 'ja va'
    id 'application'
}
sourceCompatibility = '11'
mainClassName = 'com.example.App'
repositories { ma venCentral() }
dependencies {
    testImplementation 'junit:junit:4.13.2'
}
jar {
    manifest {
        attributes 'Main-Class': mainClassName
    }
}

同样，你也可以实现依赖外置，将运行时依赖库复制到指定目录，便于管理。

task copyDependencies(type: Copy) {
    from configurations.runtimeClasspath
    into 'build/libs/lib'
}
build.dependsOn copyDependencies

执行./gradlew build后，使用ja va -jar build/libs/xxx.jar即可运行程序。

四无构建工具与进阶打包

除了Ma ven和Gradle，还有一些场景需要更直接或更高级的打包方式。

手动编译与打包（适合学习或小项目）
- 这种方式能让你透彻理解JAR包的构成。首先，编译源码：ja vac -d out src/com/example/*.ja va，-d out指定了编译输出目录。
- 接着，在src目录同级创建一个MANIFEST.MF文件，内容至少包含：
```
Manifest-Version: 1.0
Main-Class: com.example.App
```
- 最后，使用jar命令打包：jar cfm my-app.jar MANIFEST.MF -C out .。参数cfm分别表示创建文件、指定清单文件、指定主类入口。
- 运行：ja va -jar my-app.jar。
使用 jpackage 生成平台原生可执行安装包（JDK 14+）
- 这是Ja va提供的一个强大工具，可以直接生成.exe、.dmg或.deb/.rpm等安装包。一个基本示例：jpackage --type app-image --input target --name myapp --main-class com.example.App --output out。它会创建一个包含应用和精简JRE的镜像。
使用 jlink 定制精简运行时（JDK 9+，适用于模块化项目）
- 如果你的项目是模块化的，可以用jlink裁剪出一个只包含所需模块的JRE，显著减小分发体积。命令示例：jlink --module-path $JA VA_HOME/jmods:mods --add-modules ja va.base,ja va.logging,your.module.name --output custom-jre。
使用 Docker 打包发布
- 容器化部署已成为主流。一个典型的多阶段构建Dockerfile示例如下：
```
FROM openjdk:11-jdk-slim AS builder
WORKDIR /app
COPY . .
RUN ./gradlew build

FROM openjdk:11-jre-slim
WORKDIR /app
COPY --from=builder /app/build/libs/app.jar /app/app.jar
EXPOSE 8080
CMD ["ja va","-jar","/app/app.jar"]
```
  这个Dockerfile先在一个包含完整JDK的镜像中构建项目，再将生成的JAR文件复制到一个更小的只包含JRE的镜像中运行，兼顾了构建需求与运行镜像的体积。
- 构建与运行命令：docker build -t myapp . 构建镜像；docker run -p 8080:8080 myapp 运行容器。