⚡ www.xservx.com | 〓 专注Java命令行打包 | ㊣ 攻略·示例·深度

Java 命令行打包项目

⚙️ 从Jar到模块化 · 网民最关心的构建热点

深度解析 Maven、Gradle、命令行打包、依赖管理、模块化 以及周边高频问题。本站收录超过3000字实战干货。

〔 命令行打包 〕 核心构建工具

⚡

Maven 一键构建

mvn clean package 是Java开发者最熟悉的命令。通过 pom.xml 管理依赖,支持插件体系,打包为Jar/War。网民常问:如何跳过测试? mvn package -DskipTests

⚙️

Gradle 灵活高效

gradle build 基于Groovy/Kotlin DSL,增量构建更快速。适合大型项目,支持 多模块打包。常见需求:生成可执行Fat Jar → shadowJar 插件。

〓

Jar命令原生打包

不依赖工具:jar cf 创建归档,jar uf 更新。配合 MANIFEST.MF 指定主类。网民常忽略:jar --create --file myapp.jar -e com.example.Main

◎

模块化jlink

Java9+ jlink 可生成自定义运行时镜像,精简JRE。命令: jlink --module-path ... --add-modules ... --output myjre 适合云原生。

〓 命令行打包演进时间轴

2000s · 手动javac+jar

开发者手动编译,javac -d 指定输出,再用jar命令打包。易出错,无依赖管理。

2004 · Maven 兴起

约定优于配置,mvn package 成为标准。中央仓库解决依赖传递。

2012 · Gradle 崛起

基于任务图,构建速度提升。Android官方构建工具,gradle build 流行。

2017 · Java9模块化

jlink + jmod 让打包更精细,模块路径取代类路径。

〔 Maven 〕 命令行打包实战

常用Maven打包命令

  • mvn clean package — 清理并打包,生成target/*.jar
  • mvn install — 打包并安装到本地仓库,供其他模块引用
  • mvn deploy — 部署到远程仓库(Nexus等)
  • mvn package -DskipTests — 跳过测试打包
  • mvn dependency:tree — 查看依赖树,解决冲突
示例:mvn clean package -P production -Dmaven.test.skip=true

网友们还关心:如何生成可执行Jar?使用 maven-assembly-plugin 或 spring-boot-maven-plugin。

关键插件配置

〓 maven-compiler-plugin 指定Java版本:

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-compiler-plugin</artifactId>
  <configuration><source>17</source><target>17</target></configuration>
</plugin>

〓 maven-jar-plugin 配置主类:

<plugin>
  <artifactId>maven-jar-plugin</artifactId>
  <configuration>
    <archive><manifest><mainClass>com.example.Main</mainClass></manifest></archive>
  </configuration>
</plugin>

网友热搜:maven-shade-plugin 打包Fat Jar,解决依赖冲突。

多模块打包策略

〓 父POM声明模块:

<modules><module>core</module><module>service</module></modules>

在根目录执行 mvn install 会按依赖顺序构建。常用 -pl 指定模块:mvn package -pl service -am 同时构建依赖。

网友们还关心:多模块版本管理 → ci-friendly 属性 ${revision}。

〔 Gradle 〕 命令行打包进阶

Gradle 核心打包任务

  • gradle build — 完整构建+测试+打包
  • gradle jar — 仅生成jar(无依赖)
  • gradle bootJar — Spring Boot可执行jar
  • gradle clean build — 清理后构建
// build.gradle 示例
plugins { id 'java' }
jar {
  manifest { attributes 'Main-Class': 'com.example.Main' }
}

Shadow 插件 (Fat Jar)

〓 配置:id 'com.github.johnrengelman.shadow' version '8.1.1'

shadowJar {
  archiveBaseName.set('myapp')
  archiveClassifier.set('')
  mergeServiceFiles()
}
// 执行 gradle shadowJar 生成可执行jar

网友热搜:如何排除特定依赖?→ exclude 'META-INF/*.SF'

多项目构建

〓 settings.gradle: include 'core','web'

根项目执行 gradle build 构建所有子项目。使用 -p 指定项目:gradle :web:build。依赖声明:implementation project(':core')

网友们还关心:gradle assemble 仅打包不测试,适合CI。

〔 网友们还关心 〕 高频问题深度解答

① 打包后Jar无法运行 “no main manifest attribute”

原因:MANIFEST.MF 缺少Main-Class。Maven中配置 maven-jar-plugin,Gradle中配置 jar.manifest.attributes。或者使用 spring-boot-maven-plugin 自动设置。

② 如何减小打包体积?

使用 jlink 生成最小JRE;Maven中排除无用依赖;Gradle开启 proguard 或 R8;或者使用 jpackage 打包原生安装包。

③ 多模块项目如何只打包某个模块?

Maven: mvn package -pl module-name -am;Gradle: gradle :module-name:build。注意依赖传递。

④ 命令行打包时如何指定Profile?

Maven: mvn package -P production;Gradle: gradle build -Penv=production 配合 resource filtering。

⑤ 什么是Fat Jar?与普通Jar区别?

Fat Jar 包含所有依赖,可直接 java -jar 运行。普通Jar需要Classpath。构建工具通过 maven-shade 或 gradle shadow 实现。

⑥ Java模块化打包后如何运行?

使用 java --module-path 指定模块路径,--module 启动。例如: java --module-path out --module com.example/com.example.Main。

⑦ 如何解决依赖冲突?

Maven: mvn dependency:tree 分析,使用 <exclusions>。Gradle: gradle dependencies,使用 force 或 strictly 版本声明。

⑧ 打包时跳过Lint/检查?

Maven: -DskipTests -Dcheckstyle.skip=true;Gradle: -x check 或 gradle build -x test。

〔 命令行打包技巧 〕 示例与对比

工具打包命令输出格式典型场景
Mavenmvn packagejar/war企业级标准
Gradlegradle buildjarAndroid/微服务
Jarjar cfjar快速原型
jlinkjlink --output自定义镜像云原生/容器

〓 网友热搜:Java命令行打包 常见错误

  • ◆ “ClassNotFoundException” — 依赖未打包进Jar → 使用Fat Jar
  • ◆ “Invalid or corrupt jarfile” — 损坏的Jar → 检查构建过程
  • ◆ “模块化错误” — module-info.java 导出缺失 → 添加exports
  • ◆ “版本冲突” — 使用 mvn dependency:tree 定位

〓 实战示例:构建并运行一个命令行项目

// 1. 创建简单Java文件 Main.java
public class Main { public static void main(String[] args) { System.out.println("打包成功!"); } }
// 2. 使用Maven打包
// pom.xml 配置 mainClass
// 执行: mvn clean package
// 3. 运行: java -jar target/myapp.jar

〓 更多深度内容:Java命令行打包 与CI/CD集成,如Jenkins、GitHub Actions中执行 mvn package 并归档产物。网友们还关心 容器化 打包:docker build 结合多阶段构建,将Jar复制到镜像。

〔 周边热点 · 深度拓展 〕

〓 Java命令行打包 与 模块化、微服务 密不可分。Spring Boot 应用使用 spring-boot-maven-plugin 生成可执行Jar,内嵌Tomcat。Quarkus 框架则使用 mvn package -Dquarkus.package.type=uber-jar。Netty 项目常用Gradle构建。此外,jpackage 工具可将Java应用打包为原生安装包(exe/dmg),结合 jlink 减少体积。以下为网民高频搜索关联:

  • ➤ Maven wrapper (mvnw) — 无需安装Maven,./mvnw package
  • ➤ Gradle wrapper (gradlew) — 统一构建版本
  • ➤ Bazel 构建Java — 谷歌开源,支持增量
  • ➤ 命令行打包 与 Docker 结合:docker build -t myapp . 多阶段构建
  • ➤ Java 21 虚拟线程不影响打包流程,但需注意模块化

〓 深度示例:使用 Maven 打包一个包含 Log4j 的CLI工具,配置 maven-assembly-plugin 生成带依赖的Jar。网友们还关心如何加密打包后的Jar → 使用 ProGuard 混淆。总之,掌握 Java命令行打包 是Java开发者进阶必备技能。