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

想让你的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，核心在于打包时正确配置MANIFEST.MF文件，特别是指定包含main方法的类。这使得JVM知道从哪个类开始执行程序。配置好后，使用jar命令即可生成。

解决方案：

1. 编写包含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!");
       }
   }

2. 编译Java代码

   使用javac命令编译Java文件。

   javac com/example/MainApp.java

   这将在com/example目录下生成MainApp.class文件。

3. 创建MANIFEST.MF文件

   在项目的根目录下创建一个名为MANIFEST.MF的文件（注意大小写敏感）。在这个文件中，指定Main-Class属性，指向包含main方法的类。

   Manifest-Version: 1.0
   Main-Class: com.example.MainApp

   注意：Main-Class后面必须跟一个换行符。这是一个常见的错误来源。

4. 打包成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文件中的类文件。

5. 运行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文件中声明你的依赖：

    
        org.apache.commons
        commons-lang3
        3.12.0
    



    
        
            org.apache.maven.plugins
            maven-assembly-plugin
            3.3.0
            
                
                    
                        com.example.MainApp
                    
                
                
                    jar-with-dependencies
                
            
            
                
                    make-assembly
                    package
                    
                        single
                    
                
            
        
    

然后运行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

这些属性可以用来增强JAR文件的描述性和安全性。

如何通过命令行指定main方法来运行JAR包，而不用修改MANIFEST.MF？

即使JAR包的MANIFEST.MF文件没有指定Main-Class，你仍然可以通过命令行指定main方法来运行JAR包。

你可以使用以下命令：

java -cp myapp.jar com.example.MainApp

这条命令的含义是：

• java: 运行Java虚拟机。
• -cp myapp.jar: 将myapp.jar添加到类路径中。
• com.example.MainApp: 指定要运行的类。

这种方式不需要修改MANIFEST.MF文件，但需要你手动指定包含main方法的类。它在某些情况下可能很有用，例如当你需要运行一个没有正确配置MANIFEST.MF文件的第三方JAR包时。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~