很多Java开发者在打包Jar包时，会遇到默认主类与实际执行需求不匹配的问题，**指定主类可规避MANIFEST.MF配置缺陷**，**两种执行方案适配不同场景**，还能减少重复打包的时间成本。其实只要掌握正确的命令参数和配置逻辑，就能快速完成Jar包的定向执行。

## 一、Java执行Jar包的底层逻辑与核心约束
### 1.1 Jar包主类配置的官方标准
Java虚拟机执行Jar包时，默认通过内置的MANIFEST.MF文件识别主类入口，这一规则在Oracle Java SE 17官方文档2023年更新的规范中已有明确定义。该文档规定，MANIFEST.MF文件需包含Main-Class属性，属性值为带main方法的类的完整路径，虚拟机才能自动加载并执行对应的程序入口。
不难发现，多数新手开发者依赖Maven、Gradle等打包插件自动生成该配置，但当一个Jar包包含多个带main方法的类时，插件往往会随机选择主类，导致执行结果与预期不符。这种场景下，手动指定主类就成了必要操作。

### 1.2 默认主类失效的三类常见原因
《2024全球Java开发者生态报告》（JetBrains）显示，62%的Java开发者曾遇到过主类配置失效问题，其中41%的失效源于MANIFEST.MF文件遗漏Main-Class属性。
第一类失效原因是Jar包内置多主类，打包插件未配置固定主类，导致虚拟机无法确定执行入口；第二类是MANIFEST.MF文件被误删或修改，丢失核心属性；第三类是打包时未正确关联依赖Jar包，主类加载时无法找到依赖类，最终抛出ClassNotFoundException异常。其实只要提前排查这三类问题，就能避免80%以上的主类执行失败场景。

## 二、指定主类的两种主流执行方案
### 2.1 命令行直接指定主类的快速执行方案
命令行直接指定主类是临时测试场景下最高效的方案，核心是使用-cp参数替代-jar参数，明确声明Jar包路径和主类的完整路径。
具体命令格式为`java -cp demo.jar com.example.Main`，其中-cp参数用于指定类路径，demo.jar为目标Jar包名称，com.example.Main为带main方法的主类全路径。这种方案无需修改Jar包本身，适合多主类切换测试或临时调试场景。值得注意的是，若Jar包依赖其他外部Jar包，需在-cp参数中添加所有依赖包路径，用英文分号（Windows）或冒号（Linux）分隔。
该方案的优势是操作灵活，无需重新打包；局限是每次执行都要输入完整参数，不适合固定长期运行的生产场景。

### 2.2 MANIFEST.MF配置修改的持久化执行方案
MANIFEST.MF配置修改是生产部署场景下的标准方案，通过修改Jar包内置的配置文件，将指定主类写入Main-Class属性，实现一键执行。
修改配置的方式主要有两种：一是手动解压Jar包，编辑META-INF/MANIFEST.MF文件，添加`Main-Class: com.example.Main`和`Class-Path: lib/dependency1.jar lib/dependency2.jar`属性，再重新打包；二是通过Maven的maven-jar-plugin或Gradle的manifest属性自动配置，在构建脚本中声明主类路径，打包时自动生成合规的MANIFEST.MF文件。
这种方案的优势是复用性强，打包后可直接使用`java -jar demo.jar`命令执行；局限是需要重新打包，操作步骤略多，适合固定主类的长期运行场景。

### 2.3 两种执行方案的核心差异对比
以下是两种指定主类执行方案的多维度对比，便于开发者快速匹配自身场景：

| 执行方案                | 操作步骤复杂度 | 复用性       | 适用场景                     | 单次操作耗时 |
|-------------------------|----------------|--------------|------------------------------|--------------|
| 命令行直接指定主类      | 低（1步）      | 低（每次输入）| 临时测试、多主类切换执行     | 10秒以内     |
| MANIFEST.MF配置修改     | 中（2-3步）    | 高（打包即用）| 生产部署、固定主类长期运行   | 30-60秒      |

不难发现，两种方案不存在绝对优劣，开发者需要根据自身的执行场景选择适配方案，才能提升Java执行Jar包的效率。

## 三、实战配置细节与避坑指南
### 3.1 命令行指定主类的参数规范与误区
命令行指定主类的常见误区是混淆-cp和-jar参数的使用规则，很多新手会尝试使用`java -jar demo.jar com.example.Main`命令执行，这会直接导致执行失败。因为-jar参数会强制虚拟机读取Jar包内置的MANIFEST.MF配置，忽略命令行后续的主类参数，必须用-cp参数替代-jar参数才能生效。
另外，若主类全路径包含嵌套包结构，必须完整输入包名和类名，不能省略中间层级，比如`com.example.module.Main`不能简写为`module.Main`，否则会抛出NoClassDefFoundError异常。其实只要严格遵循参数规范，就能避免90%以上的命令行执行错误。

### 3.2 MANIFEST.MF配置的合规校验方法
修改MANIFEST.MF文件后，开发者需要通过`jar tf demo.jar META-INF/MANIFEST.MF`命令查看配置内容，确认Main-Class属性是否正确。值得注意的是，MANIFEST.MF文件的每个属性值末尾不能添加空格，否则虚拟机会将空格识别为类名的一部分，导致主类加载失败。
国内主流打包工具Maven的maven-jar-plugin插件，会自动校验Main-Class属性的格式，若配置路径错误会在打包阶段抛出异常，减少手动修改的失误率。开发者可以在pom.xml文件中添加`<mainClass>com.example.Main</mainClass>`配置，实现一键生成合规的MANIFEST.MF文件。

### 3.3 多依赖场景下的主类执行配置技巧
当Jar包依赖多个外部Jar包时，命令行指定主类需要将所有依赖包路径加入-cp参数中，若依赖包数量较多，输入会十分繁琐。其实可以使用通配符简化配置，比如在Linux环境下使用`java -cp demo.jar:lib/* com.example.Main`，自动加载lib目录下的所有依赖Jar包；在Windows环境下使用`java -cp demo.jar;lib/*.jar com.example.Main`，实现同样的效果。
使用MANIFEST.MF配置时，需要在Class-Path属性中列出所有依赖包的相对路径，注意依赖包路径不能包含空格，否则会导致依赖加载失败。

## 四、批量执行与自动化脚本优化
### 4.1 批量指定主类执行的Shell脚本实现
针对多Jar包多主类的批量执行场景，开发者可以编写Shell脚本实现自动化执行，减少重复操作成本。
比如编写一个遍历指定目录下Jar包的脚本，读取每个Jar包对应的主类配置文件，自动调用`java -cp`命令执行对应主类。脚本核心逻辑是通过`ls *.jar`遍历Jar包，再通过配置文件匹配主类路径，实现批量定向执行。这种方案能将批量操作时间从数分钟缩短到10秒以内，提升团队协作的执行效率。

### 4.2 持续集成流程中的主类配置最佳实践
在DevOps持续集成流程中，开发者可以通过流水线参数动态指定主类，无需手动修改打包配置。比如在GitHub Actions中，可以通过env参数传递主类路径，在打包阶段动态生成MANIFEST.MF文件，实现按需打包部署。
其实只要将主类配置与流水线参数绑定，就能实现生产环境的动态主类切换，满足不同业务场景的执行需求。《2024全球Java开发者生态报告》（JetBrains）提到，48%的企业已经将主类配置纳入CI/CD流水线，实现部署流程的自动化。

## 五、国内外工具辅助执行对比
### 5.1 国内主流打包工具的主类配置支持
国内主流Java打包工具Maven、Gradle均支持主类的灵活配置，两款工具的国内镜像站点提供稳定的插件下载服务，保证配置功能正常使用。
Maven通过maven-jar-plugin插件实现主类配置，Gradle通过`manifest { mainClassName = 'com.example.Main' }`属性快速设置主类，两款工具均能自动生成合规的MANIFEST.MF文件，减少手动操作的失误率。值得注意的是，国内开发者可以使用阿里云镜像加速插件下载，提升打包速度。

### 5.2 海外工具的差异化优势
海外工具ShadowJar是一款专为多依赖Jar包设计的打包工具，支持将所有依赖Jar包合并成单个可执行Jar包，避免依赖路径配置错误的问题。
使用ShadowJar打包时，可以直接指定主类路径，生成的Jar包无需额外配置依赖，直接通过`java -jar`命令执行即可。这种方案适合复杂项目的生产部署，减少依赖冲突的概率，提升主类执行的稳定性。

## 六、指定主类执行的性能优化建议
### 6.1 主类加载的内存优化技巧
指定主类执行时，可以通过-Xms和-Xmx参数调整虚拟机的初始内存和最大内存，提升主类加载的速度和稳定性。比如使用`java -Xms512m -Xmx1024m -cp demo.jar com.example.Main`命令，将初始内存设置为512MB，最大内存设置为1024MB，避免主类加载时出现内存溢出问题。
### 6.2 主类执行的日志配置优化
在生产场景下指定主类执行时，建议添加日志配置参数，将执行日志输出到指定文件，便于后续排查问题。比如使用`java -cp demo.jar -Dlogback.configurationFile=logback.xml com.example.Main`命令，指定logback日志配置文件，实现日志的规范化管理。

Oracle Java SE 17官方文档，2023
《2024全球Java开发者生态报告》，JetBrains，2024

可以在命令行执行JAR时使用java命令并通过-classpath参数指定JAR文件，再直接指定主类的全限定名。例如：java -cp yourfile.jar com.example.MainClass，这样会运行com.example.MainClass作为主类，而不是JAR包内的默认主类。

使用java命令指定主类运行JAR

我有一个包含多个主类的JAR包，想知道如何在执行时指定某个特定的主类启动？

如何在命令行中指定主类来运行JAR文件？

可以使用解压工具或jar命令解压JAR文件，查看MANIFEST.MF文件中的Main-Class属性来看默认主类。若想查看更多包含main方法的类，可以搜索字节码或使用IDE查看。

利用解压和查看清单文件检查可用主类

在执行指定主类之前，我想确认JAR包里有哪些可用的主类。如何查看？

如何查看JAR包中包含哪些主类？

可以解压JAR包，编辑META-INF/MANIFEST.MF文件中的Main-Class属性为新的主类全限定名，然后重新打包JAR。这样执行java -jar yourfile.jar时就默认运行新的主类。

编辑MANIFEST.MF文件中的Main-Class属性

如果我想让JAR包运行时默认使用另一个主类，如何修改设置？

能否通过修改JAR包的清单文件改变默认主类？

PingCodeDocs

这篇文章详细讲解了Java执行Jar包时指定主类的底层逻辑与两种主流方案，对比了命令行直接指定和MANIFEST.MF配置修改的差异，梳理了实战中的常见坑点与优化技巧，结合权威行业报告数据帮助开发者适配不同场景的执行需求，还提供了批量执行与自动化脚本的实现方法。

java如何执行jar指定主类

用户关注问题