Java怎么打包成jar文件

核心概念

1. JAR文件本质
   Java ARchive（JAR）是压缩格式的Java类文件、资源文件和元数据（如MANIFEST.MF）的集合,类似ZIP文件。
2. 可执行JAR要求
   MANIFEST.MF文件中必须指定主类：Main-Class: com.example.Main

打包方法详解

方法1：使用IDE（推荐初学者）

IntelliJ IDEA步骤：

1. 打开项目 → 顶部菜单选 File > Project Structure
2. 左侧 Artifacts → 点 → JAR > From modules with dependencies
3. 选择主类（Main Class）→ 设置输出目录（Output directory）
4. 点击 Apply → 返回编辑器，顶部菜单 Build > Build Artifacts
5. 选择 Build → 生成的JAR在项目目录的out/artifacts/下

Eclipse步骤：

1. 右键项目 → Export → 搜索 Runnable JAR file
2. 选择启动配置（Launch configuration）和主类
3. 设置输出路径 → 选择依赖处理方式：
   • Extract required libraries：解压依赖到JAR内（适合简单项目）
   • Package required libraries：依赖JAR放入同级libs文件夹
4. 点击 Finish

方法2：使用Maven（自动化构建）

1. 配置pom.xml
   添加maven-jar-plugin和主类声明：

   <build>
     <plugins>
       <plugin>
         <groupId>org.apache.maven.plugins</groupId>
         <artifactId>maven-jar-plugin</artifactId>
         <version>3.3.0</version>
         <configuration>
           <archive>
             <manifest>
               <mainClass>com.example.Main</mainClass> <!-- 替换为你的主类 -->
             </manifest>
           </archive>
         </configuration>
       </plugin>
     </plugins>
   </build>

2. 生成可执行JAR
   终端执行：

   mvn clean package

3. 输出位置
   生成的JAR在target/目录，命名为项目名-版本.jar

处理依赖（生成含依赖的Fat JAR）
使用maven-assembly-plugin：

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

执行mvn package后，target/目录生成项目名-版本-jar-with-dependencies.jar

方法3：使用Gradle

1. 配置build.gradle
   启用application插件并指定主类：

   plugins {
     id 'application'
   }
   application {
     mainClass = 'com.example.Main' // 替换为你的主类
   }

2. 生成标准JAR
   执行：

   gradle jar

   JAR输出在build/libs/

生成Fat JAR
添加shadow插件（推荐）：

plugins {
  id 'com.github.johnrengelman.shadow' version '8.1.1'
}

执行：

gradle shadowJar

输出文件为build/libs/项目名-all.jar

方法4：手动打包（理解原理）

1. 编译所有Java文件

   javac -d ./out src/**/*.java

2. 创建MANIFEST.MF
   在out/目录新建MANIFEST.MF

   Manifest-Version: 1.0
   Main-Class: com.example.Main  # 替换主类
   Class-Path: libs/dependency1.jar libs/dependency2.jar  # 若有依赖

3. 打包JAR

   jar cvfm app.jar ./out/MANIFEST.MF -C ./out .

   • c创建新JAR
   • v输出详细信息
   • f指定文件名
   • m包含清单文件

运行与验证

• 启动命令

  java -jar your-app.jar

• 依赖处理
  若依赖在外部libs/目录，需保持MANIFEST.MF中Class-Path路径一致。

常见问题解决

1. “no main manifest attribute”
   原因：未指定主类。
   修复：检查MANIFEST.MF的Main-Class路径是否正确,或重新配置构建工具。
2. ClassNotFoundException
   原因：依赖未包含。
   修复：
   • 使用Fat JAR打包（推荐）
   • 或将依赖JAR放入Class-Path指定目录
3. 编码问题
   编译时指定编码：

   javac -encoding UTF-8 ...

最佳实践

• 自动化构建：优先用Maven/Gradle，减少手动错误
• 版本管理：在JAR名中包含版本号（如app-1.0.0.jar）
• 依赖隔离：生产环境推荐使用Docker容器化部署
• 安全扫描：使用OWASP Dependency-Check扫描依赖漏洞

引用说明基于Oracle官方JAR文档、Apache Maven指南、Gradle手册及IDE官方文档综合整理，确保方法经过实践验证，具体命令参数可参考：

• Oracle JAR工具：https://docs.oracle.com/javase/tutorial/deployment/jar/
• Maven JAR插件：https://maven.apache.org/plugins/maven-jar-plugin/
• Gradle Shadow插件：https://github.com/johnrengelman/shadow