当开发者询问「java怎么编译jar」时,实质是在探索整个Java应用的构建闭环——从源码到可分发的归档文件。此过程远非单一命令可概括,它涉及编译、打包、清单管理、依赖处理及运行时配置等多环节协同。
首先需明确:Java源码(.java)经javac编译为字节码(.class),随后通过jar工具将多个.class文件及资源文件压缩为单一JAR(Java ARchive)文件。JAR本质是ZIP格式,含META-INF/MANIFEST.MF清单文件,定义主类、类路径等元数据。
| 术语 | 说明 | 典型值示例 |
|---|---|---|
| .class | Java字节码文件 | HelloWorld.class |
| JAR | Java归档文件 | app-1.0.0.jar |
| MANIFEST.MF | 清单文件 | Main-Class: com.example.Main |
| Class-Path | 依赖库路径声明 | Class-Path: lib/dep.jar |
| 入口点 | 程序启动类 | public static void main(String[] args) |
值得注意的是,现代开发中JAR构建常由构建工具自动化处理,但理解底层机制对排查问题至关重要。例如:ClassNotFoundException常源于MANIFEST.MF缺失或Class-Path路径错误;NoClassDefFoundError则多因编译与运行时类路径不一致。
以下演示不依赖任何构建工具的纯命令行方式,适用于理解原理或简单项目。
假设项目结构如下:
src/
└── com/
└── example/
└── Main.java
Main.java内容:
package com.example;
public class Main {
public static void main(String[] args) {
System.out.println("Hello from java怎么编译jar示例!");
}
}
在项目根目录执行:
javac -d out src/com/example/Main.java
说明:-d out指定输出目录为out,生成结构:
out/
└── com/
└── example/
└── Main.class
新建manifest.mf文件(注意末尾必须有空行):
Manifest-Version: 1.0 Main-Class: com.example.Main
jar cfm app.jar manifest.mf -C out/ .
参数含义:
• c:创建新归档
• f:指定归档文件名
• m:包含自定义清单
• -C out/ .:切换到out目录并打包所有内容
java -jar app.jar
输出:Hello from java怎么编译jar示例!
| 错误现象 | 根本原因 | 解决方案 |
|---|---|---|
| no main manifest attribute | MANIFEST.MF缺失Main-Class | 确保清单含Main-Class: 完整类名 |
| Could not find or load main class | 类路径或包声明错误 | 检查package语句与目录结构一致性 |
| ClassNotFoundException | 依赖JAR未在Class-Path中 | 在manifest中添加Class-Path: lib/xxx.jar |
| SecurityException | 签名JAR被修改 | 移除META-INF/*.SF/.DSA/.RSA文件 |
Maven通过约定优于配置原则简化构建流程,其生命周期将编译、测试、打包自动串联。
mvn archetype:generate -DgroupId=com.example \ -DartifactId=jar-demo \ -DarchetypeArtifactId=maven-archetype-quickstart \ -DinteractiveMode=false
根目录pom.xml关键片段:
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.11.0</version>
<configuration>
<source>17</source>
<target>17</target>
</configuration>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-jar-plugin</artifactId>
<version>3.3.0</version>
<configuration>
<archive>
<manifest>
<mainClass>com.example.App</mainClass>
</manifest>
</archive>
</configuration>
</plugin>
</plugins>
</build>
mvn clean package java -jar target/jar-demo-1.0-SNAPSHOT.jar
| 特性 | Maven | Gradle |
|---|---|---|
| 配置语言 | XML | Kotlin/DSL |
| 构建速度 | 中等 | 快(增量构建) |
| 学习曲线 | 平缓 | 较陡 |
| 插件生态 | 丰富 | 增长迅速 |
| 多模块支持 | 优秀 | 极佳 |
解决依赖冲突问题,将依赖库打包进主JAR。Maven配置:
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-shade-plugin</artifactId>
<version>3.5.0</version>
<executions>
<execution>
<phase>package</phase>
<goals><goal>shade</goal></goals>
<configuration>
<transformers>
<transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
<mainClass>com.example.Main</mainClass>
</transformer>
</transformers>
</configuration>
</execution>
</executions>
</plugin>
生成JAR可独立运行,避免运行时依赖冲突。典型场景:Spring Boot应用打包。
JDK 9+支持模块系统,通过module-info.java定义模块契约:
module com.example {
requires java.base;
exports com.example;
}
编译命令:
javac --module-source-path src \ -d out \ src/com.example/module-info.java \ src/com.example/com/example/Main.java jar --create --file=app.jar \ --main-class=com.example.Main \ -C out/ .
优势:模块间依赖清晰、减少运行时内存占用、增强安全性。
生产环境通常移除调试信息以减小体积:
javac -g:none -d out src/com/example/Main.java
开发时保留调试信息:
javac -g:lines,vars,source -d out src/com/example/Main.java
Gradle配置:
tasks.withType(JavaCompile) {
options.compilerArgs += ['-g:lines,vars,source']
}
A:MANIFEST.MF中的Class-Path需为相对路径,且必须位于JAR同级目录。例如:
Class-Path: lib/dep.jar
实际路径应为:
your-app.jar
lib/dep.jar
错误示例:JAR在/home/user/,Class-Path却写成/home/user/lib/xxx.jar
A:三种方案:
① 手动合并:将依赖JAR内容解压到项目输出目录
② Class-Path:在MANIFEST.MF声明依赖路径
③ 阴影JAR:使用构建插件打包依赖
A:确保源码编码与编译器一致:
javac -encoding UTF-8 -d out src/*.java
Maven配置:
<properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> </properties>