使用IDEA打包Java项目生成可执行JAR时，如何正确配置主类？

Question

在使用 IntelliJ IDEA 打包 Java 项目生成可执行 JAR 文件时，一个常见的问题是：**如何正确配置主类（Main Class）以确保 JAR 包能够直接运行？** 用户常常遇到“no main manifest attribute”或“找不到或无法加载主类”的错误，这通常是因为未在 JAR 的 MANIFEST.MF 文件中指定主类。那么，在 IDEA 中应如何通过 Artifacts 配置，正确设置 Main-Class 属性，并确保构建后的 JAR 可以通过 java -jar 命令直接运行？

Answer 1

在 IntelliJ IDEA 中配置主类生成可执行 JAR 文件的完整指南

在使用 IntelliJ IDEA 打包 Java 项目为可执行 JAR 文件时，一个常见的问题是：如何正确配置主类（Main Class）以确保 JAR 包能够直接运行？用户常常遇到“no main manifest attribute”或“找不到或无法加载主类”的错误。这些问题通常是因为未在 JAR 的 MANIFEST.MF 文件中指定主类。

本文将从基础概念、配置步骤、常见问题及解决方案等方面进行深入分析，并结合实际操作演示，帮助开发者掌握完整的打包流程。

1. 理解 JAR 文件与 MANIFEST.MF 的作用

JAR（Java Archive）文件是 Java 平台的标准归档格式，用于打包多个类文件、资源文件以及元数据。其中，META-INF/MANIFEST.MF 是关键的元数据文件，用于描述 JAR 包的基本信息，包括版本号、依赖关系、以及最重要的 —— 主类入口（Main-Class）。

如果未在 MANIFEST.MF 中指定 Main-Class，则使用 java -jar your.jar 命令运行时会抛出如下异常：

Error: Could not find or load main class
no main manifest attribute, in your.jar
    

2. 在 IntelliJ IDEA 中通过 Artifacts 配置主类

IntelliJ IDEA 提供了图形化界面来配置 Artifacts，可以非常直观地设置主类并生成带有 Main-Class 属性的 JAR 文件。以下是详细步骤：

1. 打开项目后，点击顶部菜单栏中的 File → Project Structure（快捷键 Ctrl+Alt+Shift+S）。
2. 在弹出窗口左侧选择 Artifacts。
3. 点击 + 号，选择 JAR → From modules with dependencies。
4. 选择主类所在的模块（Module），并在下拉列表中选择对应的主类（Main Class）。
5. 确认输出布局是否包含所有必要的依赖和资源。
6. 点击 Apply，然后 Build → Build Artifacts 来生成 JAR 文件。

步骤	操作说明
1	进入 Project Structure → Artifacts
2	添加新 Artifact 类型为 JAR
3	选择模块并指定 Main Class
4	Build Artifact 生成 JAR 文件

3. 检查生成的 MANIFEST.MF 文件内容

生成 JAR 后，可以通过以下命令查看 MANIFEST.MF 内容：

jar xf your.jar META-INF/MANIFEST.MF
cat META-INF/MANIFEST.MF
    

正常情况下应包含类似如下内容：

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

4. 常见问题与解决方法

• 主类路径不正确：确保主类名称拼写正确，且包含完整的包名。
• MANIFEST.MF 文件缺失：检查构建配置是否启用 MANIFEST 生成。
• 依赖库未打包进去：建议使用 Maven 或 Gradle 插件生成 fat jar。

5. 使用 Maven 和 Gradle 自动配置 Main-Class

对于现代 Java 项目，推荐使用构建工具（如 Maven 或 Gradle）来自动生成可执行 JAR，并自动设置 Main-Class。以下是两个示例：

Maven 示例（pom.xml）

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-jar-plugin</artifactId>
            <configuration>
                <archive>
                    <manifest>
                        <mainClass>com.example.Main</mainClass>
                    </manifest>
                </archive>
            </configuration>
        </plugin>
    </plugins>
</build>
    

Gradle 示例（build.gradle）

jar {
    manifest {
        attributes(
            'Main-Class': 'com.example.Main'
        )
    }
}
    

6. 构建流程图示意

graph TD
            A[编写 Java 代码] --> B[配置 Main-Class]
            B --> C{构建方式}
            C -->|IDEA Artifacts| D[使用 Project Structure 设置主类]
            C -->|Maven/Gradle| E[配置插件生成可执行 JAR]
            D --> F[Build Artifact 生成 JAR]
            E --> G[执行 mvn package 或 gradle build]
            F --> H[JAR 包含 Main-Class]
            G --> H
            H --> I[验证 JAR 是否可执行]