当前位置：首页 > 文章列表 > 文章 > java教程 > 手把手教你用Java生成可执行JAR！轻松配置main类

手把手教你用Java生成可执行JAR！轻松配置main类

2025-06-17 10:09:25 0浏览收藏

想让你的Java程序一键运行？本文手把手教你如何生成可执行JAR包！核心在于正确配置`MANIFEST.MF`文件，指定包含`main`方法的类作为程序的入口。文章详细介绍了从编写Java类、编译代码、创建`MANIFEST.MF`文件，到使用`jar`命令打包的完整步骤，并提供了常见问题排查，例如`MANIFEST.MF`格式错误、`Main-Class`拼写错误等。针对依赖第三方库的项目，推荐使用Maven或Gradle构建工具，生成包含所有依赖的“fat JAR”。此外，还介绍了`MANIFEST.MF`文件的其他重要属性，以及如何通过命令行指定`main`方法运行JAR包，无需修改`MANIFEST.MF`文件。掌握这些技巧，让你的Java程序部署更便捷！

在Java中生成可执行JAR的核心是正确配置MANIFEST.MF文件并指定main类。1. 编写包含public static void main方法的Java类；2. 使用javac编译代码生成.class文件；3. 创建MANIFEST.MF文件并在其中声明Main-Class属性，注意确保类名正确且文件末尾有换行符；4. 使用jar cfm命令打包生成JAR文件；5. 通过java -jar运行JAR。若无法运行，需检查MANIFEST.MF格式、Main-Class拼写、是否存在必要依赖及Java版本兼容性。对于依赖第三方库的项目，推荐使用Maven或Gradle生成包含所有依赖的“fat JAR”，例如通过Maven的maven-assembly-plugin插件配置并执行mvn clean package assembly:single命令。MANIFEST.MF还支持Class-Path、版本描述、密封等属性，也可通过命令行使用-cp参数指定主类运行JAR而无需修改MANIFEST.MF。

Java中如何生成可执行JAR 掌握main类配置

Java中生成可执行JAR，核心在于打包时正确配置MANIFEST.MF文件，特别是指定包含main方法的类。这使得JVM知道从哪个类开始执行程序。配置好后，使用jar命令即可生成。

解决方案：

编写包含main方法的Java类
这是最基础的一步。确保你的Java代码中有一个类包含了public static void main(String[] args)方法。例如：
```
package com.example;

public class MainApp {
    public static void main(String[] args) {
        System.out.println("Hello, World!");
    }
}
```
编译Java代码
使用javac命令编译Java文件。
```
javac com/example/MainApp.java
```
这将在com/example目录下生成MainApp.class文件。
创建MANIFEST.MF文件
在项目的根目录下创建一个名为MANIFEST.MF的文件（注意大小写敏感）。在这个文件中，指定Main-Class属性，指向包含main方法的类。
```
Manifest-Version: 1.0
Main-Class: com.example.MainApp
```
注意：Main-Class后面必须跟一个换行符。这是一个常见的错误来源。
打包成JAR文件
使用jar命令打包。
```
jar cfm myapp.jar MANIFEST.MF com/example/*.class
```
这条命令的含义是：
- c: 创建一个新的JAR文件。
- f: 指定JAR文件的名称为myapp.jar。
- m: 使用指定的MANIFEST.MF文件。
- MANIFEST.MF: 指定使用哪个MANIFEST文件。
- com/example/*.class: 指定要包含在JAR文件中的类文件。
运行JAR文件
现在，你可以使用java -jar命令运行JAR文件了。
```
java -jar myapp.jar
```
如果一切顺利，你应该能在控制台上看到"Hello, World!"。

JAR包生成后无法运行：常见问题排查

首先，检查MANIFEST.MF文件。确保Main-Class属性指向的类名是完全正确的，包括包名。一个小小的拼写错误都可能导致程序无法启动。其次，确保MANIFEST.MF文件最后有一个换行符。很多人会忽略这一点，导致文件解析失败。

再者，确认JAR包中包含了所有必要的依赖。如果你的程序依赖于其他的JAR包，你需要将这些依赖也包含在可执行JAR中，或者在运行JAR包时通过-classpath参数指定。

最后，检查你的Java版本。如果你的代码是用高版本的Java编译的，而你尝试用低版本的Java运行，可能会出现兼容性问题。

如何处理依赖第三方库的Java项目打包成可执行JAR？

如果你的项目依赖了第三方库，仅仅将你的.class文件打包成JAR是不够的。你需要将这些依赖也一起打包进去。

一种方法是使用Maven或Gradle等构建工具，它们可以自动处理依赖关系，并生成包含所有依赖的“fat JAR”或“uber JAR”。这些工具会自动下载所需的依赖，并将它们打包到最终的JAR文件中。

另一种方法是手动将所有依赖的JAR文件解压，然后将解压后的类文件添加到你的JAR文件中。但这比较繁琐，容易出错，不推荐使用。

例如，使用Maven，你可以在pom.xml文件中声明你的依赖：

<dependencies>
    <dependency>
        <groupId>org.apache.commons</groupId>
        <artifactId>commons-lang3</artifactId>
        <version>3.12.0</version>
    </dependency>
</dependencies>

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-assembly-plugin</artifactId>
            <version>3.3.0</version>
            <configuration>
                <archive>
                    <manifest>
                        <mainClass>com.example.MainApp</mainClass>
                    </manifest>
                </archive>
                <descriptorRefs>
                    <descriptorRef>jar-with-dependencies</descriptorRef>
                </descriptorRefs>
            </configuration>
            <executions>
                <execution>
                    <id>make-assembly</id>
                    <phase>package</phase>
                    <goals>
                        <goal>single</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

然后运行mvn clean package assembly:single命令，Maven会自动生成一个包含所有依赖的可执行JAR文件。

除了使用构建工具，还可以使用一些专门的JAR打包工具，例如One-JAR或ShadowJar。这些工具可以更灵活地处理依赖关系，并生成更小的JAR文件。

除了Main-Class，MANIFEST.MF文件还有哪些其他重要的属性？

MANIFEST.MF文件不仅仅只有Main-Class属性。它还包含许多其他有用的属性，可以用来配置JAR文件的行为。

Class-Path: 指定JAR文件依赖的其他JAR文件的路径。这可以用来指定外部依赖，而无需将它们打包到同一个JAR文件中。
```
Class-Path: lib/commons-lang3-3.12.0.jar lib/gson-2.8.9.jar
```
Specification-Title, Specification-Version, Specification-Vendor: 用于指定JAR文件的规范标题、版本和供应商。这些属性可以用来描述JAR文件的用途和来源。
```
Specification-Title: My Application
Specification-Version: 1.0
Specification-Vendor: My Company
```
Implementation-Title, Implementation-Version, Implementation-Vendor: 用于指定JAR文件的实现标题、版本和供应商。这些属性可以用来描述JAR文件的具体实现。
```
Implementation-Title: My Application Implementation
Implementation-Version: 1.0.1
Implementation-Vendor: My Company
```
Sealed: 用于指定JAR文件是否被密封。如果一个JAR文件被密封，那么它的所有类都必须来自同一个包。
```
Sealed: true
```