纯Java项目打包是企业应用交付的核心环节，**纯Java项目打包核心是匹配部署场景选择打包格式**，同时**分层打包可降低镜像体积60%以上**，结合实战经验可覆盖本地调试、云原生部署等多场景需求，帮助开发团队缩短交付周期，减少部署故障。

## 一、纯Java项目打包前置选型
### 1. 按部署场景匹配打包格式
其实，纯Java项目打包的第一步不是动手构建，而是结合最终部署场景确定打包格式。本地单人调试阶段，普通Jar包就能满足快速启动、日志查看的需求，无需额外配置即可通过java -jar命令运行。面向企业级Web容器部署时，War包会自动适配Tomcat、Jetty等容器的目录结构，省去手动配置Context的步骤。针对云原生K8s集群部署，分层Jar包则能通过镜像层复用大幅降低构建和推送时间。Gartner, 2024云原生Java应用交付报告显示，当前云原生Java应用采用分层打包的比例已从2022年的32%提升至2024年的68%，成为主流交付格式。下文将逐一拆解各类打包格式的实操流程。

| 打包格式 | 适用场景 | 构建复杂度 | 部署成本 |
| --- | --- | --- | --- |
| 普通Jar包 | 本地调试、轻量服务部署 | 低 | 低 |
| 可执行Jar包 | 独立服务部署 | 中 | 中 |
| War包 | Web容器部署 | 中 | 中 |
| 分层Jar包 | 云原生镜像构建 | 高 | 低（长期） |

### 2. 依赖与编译环境预校验
值得注意的是，打包前必须完成依赖版本和编译环境的校验，避免因版本不一致引发的构建失败。开发团队可通过构建工具的dependency:tree命令梳理所有间接依赖，排查冲突版本的依赖包，比如commons-logging与slf4j的常见冲突。同时需要确保本地JDK版本与生产环境JDK版本保持一致，尤其是跨JDK 8与JDK 17的项目，需提前配置编译参数指定目标版本，防止出现字节码不兼容的问题。完成预校验后，就能正式进入具体打包流程。

## 二、传统Jar包打包全流程
### 1. 原生Javac命令手动打包
纯Java项目手动打包适合代码量在10个文件以内的小型验证项目，步骤清晰且无需额外工具。首先在本地终端通过javac命令将Java源文件编译为class文件，编译时需指定class文件输出目录，并通过-cp参数引入依赖包路径。编译完成后，进入class文件根目录，使用jar cvf命令将所有class文件打包为Jar包，打包时可通过-m参数指定MANIFEST.MF配置文件，添加版本号、作者信息等元数据。手动打包虽然灵活，但无法批量处理依赖包引入问题，适合快速验证功能而非规模化交付。

### 2. Maven自动化Jar包构建
对于规模化交付的纯Java项目，Maven是当前企业使用较多的自动化构建工具，能统一管理依赖和打包流程。开发团队只需在pom.xml文件中配置maven-jar-plugin插件，指定打包后的Jar包名称、输出目录，以及主类入口路径。配置完成后，执行mvn clean package命令即可完成打包，同时自动跳过测试环节可添加-DskipTests参数。其实，很多团队会结合Git CI/CD流程，将Maven打包命令集成到流水线中，实现代码提交后自动完成打包和上传镜像仓库。

### 3. Gradle标准化打包配置
Gradle作为新一代构建工具，在灵活性和构建速度上相比Maven有一定优势，适合多模块纯Java项目打包。在build.gradle文件中，开发团队可通过jar配置块指定主类、依赖引入规则，以及打包后的文件目录结构。执行gradle build命令即可完成多模块并行打包，同时支持增量构建，仅重新打包修改过的模块，可将多模块项目打包时间从20分钟压缩至5分钟以内。选择Gradle还是Maven，主要取决于团队既有技术栈的适配性，两者均能稳定支撑纯Java项目打包需求。

## 三、可执行Jar包构建方案
### 1. MANIFEST.MF自定义配置
可执行Jar包的核心是MANIFEST.MF配置文件，通过配置Main-Class参数指定项目启动主类，Class-Path参数引入依赖包路径，确保JVM启动时能加载到所有必要的类文件。手动配置时需注意Class-Path参数中的依赖包路径需为相对路径，且多个依赖包之间用空格分隔，不能使用换行符。不过手动配置MANIFEST.MF容易出现路径错误，引发启动失败，建议结合构建工具自动生成配置文件。

### 2. 构建插件一键生成可执行Jar
开发团队可通过Maven的spring-boot-maven-plugin或Gradle的application插件，一键生成可执行Jar包，无需手动配置MANIFEST.MF文件。以Maven为例，在pom.xml中引入插件后，执行mvn clean package命令即可生成包含所有依赖的可执行Jar包，直接通过java -jar命令就能启动项目。Forrester, 2023 Java应用构建效率提升白皮书指出，47%的Java开发团队会采用可执行Jar包方案实现独立服务快速部署，减少容器配置环节的工作量。

### 3. 依赖分离与外置配置
对于依赖包体积较大的纯Java项目，可采用依赖外置的打包方案，将依赖包与业务代码Jar包分离，降低单次传输体积。开发团队可通过Maven的dependency:copy-dependencies命令将所有依赖包复制到指定目录，再在MANIFEST.MF中配置Class-Path指向依赖目录，启动时只需将业务Jar包和依赖目录放在同一路径下即可运行。这种方案适合带宽有限的离线部署场景，能将单次部署的文件传输体积从500MB压缩至50MB以内，大幅提升部署效率。

## 四、分层打包与镜像适配
### 1. 分层打包核心逻辑
分层打包的核心是将项目文件按变更频率划分为不同层级，将不变的依赖层、配置层与频繁变更的业务代码层分开打包，实现容器镜像构建时的层级缓存复用。例如，依赖层通常每月仅更新1-2次，而业务代码层可能每天更新多次，采用分层打包后，容器构建时只需重新打包业务代码层，复用已缓存的依赖层镜像，可将镜像构建时间从平均12分钟压缩至3分钟以内。不难发现，分层打包已经成为云原生Java应用的标配方案，能有效降低云原生交付的时间成本。

### 2. 构建工具分层配置
Maven和Gradle都提供了分层打包的插件支持，其中Maven的jib插件无需本地Docker环境就能直接将分层Jar包推送到远程镜像仓库，配置流程简单易懂。在pom.xml中引入jib插件后，开发团队可指定依赖层、资源层、代码层的目录结构，执行mvn jib:build命令即可完成分层镜像构建和推送。Gradle用户则可通过jib插件的gradle配置块，实现相同的分层打包效果，适配多模块项目的分层构建需求。

### 3. 容器镜像加速部署
分层打包后的Jar包适配容器镜像构建流程，能与K8s集群的滚动更新机制完美结合，实现服务零停机部署。推送镜像时，仅传输变更的业务代码层，无需重复推送依赖层镜像，可将镜像推送时间从15分钟压缩至2分钟以内。同时，分层镜像还支持镜像版本回滚，当新版本出现故障时，可快速回滚到旧版本镜像，减少业务中断时间，提升服务可用性。

## 五、多环境打包配置方案
### 1. 多环境配置文件隔离
纯Java项目通常需要适配开发、测试、生产等多个环境，打包前需完成配置文件的隔离管理。开发团队可在resources目录下创建dev、test、prod三个子目录，分别存放对应环境的数据库配置、接口地址、日志级别等信息，确保不同环境的配置相互独立，避免出现生产环境使用测试配置的风险。配置文件隔离后，还需通过构建工具实现打包时的环境切换。

### 2. 打包时动态切换配置
Maven的profiles配置块支持打包时动态切换环境配置，开发团队可在pom.xml中为每个环境创建对应的profile，指定该环境下的配置文件目录，执行mvn clean package -Pprod命令即可生成生产环境的打包产物。Gradle则可通过buildTypes配置块实现相同的多环境打包效果，同时支持为不同环境配置不同的编译参数和依赖版本，适配多环境的差异化需求。动态切换配置能有效降低人工修改配置的出错概率，提升多环境交付效率。

### 3. 敏感信息加密处理
**敏感配置信息需通过加密插件处理后再打包**，避免明文泄露风险。开发团队可通过Maven的jasypt-maven-plugin插件对数据库密码、接口密钥等敏感信息进行加密，在打包时自动解密后加载到项目中，确保敏感信息不会以明文形式出现在打包产物中。同时，加密密钥应存储在构建流水线的环境变量中，避免写入配置文件，进一步提升敏感信息的安全性。

## 六、打包质量校验与优化
### 1. 打包产物合规校验
打包完成后需对产物进行合规校验，确保Jar包符合企业交付标准。开发团队可通过maven-enforcer-plugin插件检查依赖版本冲突、License合规性、JDK版本兼容性等内容，自动拦截不符合标准的打包产物。同时需检查Jar包中是否包含无用的测试类、临时文件，避免占用额外存储空间。合规校验能提前发现交付隐患，减少生产环境部署后的故障发生率。

### 2. Jar包体积瘦身策略
Jar包体积过大不仅会增加部署传输时间，还会占用更多服务器磁盘空间，开发团队可通过多种策略实现Jar包瘦身。首先可通过maven-dependency-plugin移除无用的依赖包，排除项目未使用的间接依赖；其次可通过maven-shade-plugin合并重复依赖，减少Jar包中的冗余文件；最后可将静态资源文件从Jar包中分离，通过CDN加速访问，进一步降低Jar包体积。**合理的瘦身策略可将Jar包体积降低30%以上**，提升部署效率。

### 3. 依赖冲突排查方案
依赖冲突是纯Java项目打包中常见的问题，主要表现为NoClassDefFoundError或ClassNotFoundException错误。开发团队可通过mvn dependency:tree命令梳理所有依赖的版本关系，找到冲突的依赖包，通过exclude标签在pom.xml中排除低版本或无效的依赖包，确保项目使用统一的依赖版本。同时可结合IDE的依赖分析工具，可视化排查依赖冲突问题，提升排查效率。

## 七、合规与安全打包规范
### 1. 开源依赖合规校验
纯Java项目通常会引入大量开源依赖包，打包前需完成开源依赖的合规校验，避免使用不符合企业License政策的开源包。开发团队可通过OWASP Dependency-Check工具扫描依赖包的License类型、漏洞风险，生成合规报告，排查包含强Copyleft协议的依赖包，替换为符合宽松协议的依赖包。合规校验能避免企业因开源License问题引发的法律风险，保障项目交付的合规性。

### 2. 漏洞扫描与修复
**开源依赖漏洞是Java应用生产环境安全故障的主要诱因之一**，打包前需完成依赖包的漏洞扫描与修复。开发团队可结合代码扫描工具，扫描依赖包中的公开漏洞，根据漏洞严重程度优先修复高危和临界漏洞。对于暂时无法修复的漏洞，需制定临时缓解措施，比如通过配置防火墙限制漏洞暴露的端口，避免漏洞被利用。

### 3. 打包后签名认证
所有对外交付的Java包需进行数字签名，防止包文件被篡改或注入恶意代码。开发团队可通过jarsigner工具对Jar包进行签名，使用企业数字证书对包文件进行加密，确保包文件的完整性和来源可追溯性。部署时JVM会自动验证Jar包的签名，拒绝加载未签名或签名无效的包文件，提升项目部署的安全性。

Gartner, 2024 云原生Java应用交付报告
Forrester, 2023 Java应用构建效率提升白皮书

在项目的pom.xml文件中，配置maven-jar-plugin插件，指定mainClass属性为项目的主类包名和类名。然后在项目根目录执行命令mvn clean package，Maven会自动编译并生成包含入口点的JAR文件。

通过Maven打包纯Java项目为可执行JAR的步骤

我有一个纯Java项目，想用Maven来打包成可执行的JAR文件，应该如何配置和执行？

如何使用Maven工具为纯Java项目生成可执行的JAR包？

通过在pom.xml中配置maven-shade-plugin插件，它可以将项目及依赖的所有jar合并成一个单独的JAR文件，方便部署和运行。配置好后执行mvn package命令即可得到包含所有依赖的胖JAR。

使用Maven Shade插件生成包含依赖的胖JAR包

我希望打包好的纯Java项目JAR文件能包含所有依赖的第三方库，避免运行时缺少依赖，有什么方法？

纯Java项目打包成JAR时如何包含依赖库？

在IntelliJ IDEA里，可以通过'File -> Project Structure -> Artifacts'中新建一个JAR包artifact，选择包含编译输出和所需资源，配置主类。之后通过'Build -> Build Artifacts'来生成可执行的JAR文件。

利用IntelliJ IDEA的构建功能导出JAR文件

我用的是IntelliJ IDEA开发纯Java项目，想知道怎么通过IDE内置功能一键打包？

纯Java项目使用IDE（如IntelliJ IDEA）怎么快速打包？

PingCodeDocs

本文讲解纯Java项目打包的全流程，从部署场景选型出发，介绍普通Jar包、可执行Jar包、War包和分层Jar包的构建方案，涵盖手动打包、Maven与Gradle自动化打包实操技巧，同时分享多环境配置切换、依赖冲突排查、打包产物优化与安全合规校验等实战经验，帮助开发团队匹配场景选择合适的打包策略，提升交付效率与安全性。

纯java项目如何打包

用户关注问题