在Java开发中，命令行打包是开发者必须掌握的基础技能之一，它通过使用Java Development Kit（JDK）提供的工具将编译后的.class文件、资源文件等打包成可执行的JAR文件或WAR文件，便于部署和分发，本文将详细介绍Java命令行打包的完整流程，包括环境准备、常用工具、打包步骤及常见问题的解决方案。
环境准备
在进行Java命令行打包之前，需确保已正确安装JDK并配置环境变量,具体步骤如下：
- 安装JDK：从Oracle官网或OpenJDK下载适合操作系统的JDK版本,并完成安装。
- 配置环境变量：在系统环境变量中添加
JAVA_HOME变量，指向JDK的安装目录（如C:\Program Files\Java\jdk-11），并将%JAVA_HOME%\bin添加到Path变量中,以便在命令行中直接使用Java命令。 - 验证安装：打开命令行工具，输入
java -version和javac -version,若显示版本信息则表示配置成功。
常用打包工具
Java命令行打包主要依赖以下工具：
- jar工具：JDK自带的命令行工具,用于创建和管理JAR文件。
- javac工具：用于将.java源文件编译为.class文件。
- java工具：用于运行已编译的Java程序。
打包步骤
编译源代码
假设有一个简单的Java项目，包含src/com/example/Main.java和src/com/example/Utils.java两个源文件，以及resources/config.properties资源文件，首先使用javac编译源代码：
javac -d bin src/com/example/*.java
-d bin：指定编译后的.class文件输出目录为bin。- 编译完成后，
bin目录下会生成com/example/Main.class和com/example/Utils.class文件。
创建JAR文件
使用jar工具将编译后的文件和资源文件打包为JAR文件,以下是具体命令：
jar cvf myapp.jar -C bin . -C resources .
c：创建新的JAR文件。v：生成详细输出,显示打包过程。f：指定JAR文件名（如myapp.jar）。-C bin .：切换到bin目录，并将所有文件（表示当前目录所有内容）添加到JAR中。-C resources .：切换到resources目录,并将资源文件添加到JAR中。
创建可执行JAR文件
若需将JAR文件设为可执行（通过java -jar运行），需在JAR中添加META-INF/MANIFEST.MF文件，并指定主类,步骤如下：
- 创建MANIFEST.MF文件：在项目根目录下创建
META-INF文件夹，并添加MANIFEST.MF如下：Manifest-Version: 1.0 Main-Class: com.example.Main - 重新打包JAR文件：
jar cvfm myapp.jar META-INF/MANIFEST.MF -C bin . -C resources .
m：从指定文件（META-INF/MANIFEST.MF）中提取清单信息。
验证JAR文件
使用以下命令验证JAR文件是否创建成功：
jar tf myapp.jar
t：列出JAR文件的内容。- 若输出包含
com/example/Main.class和config.properties等文件,则表示打包成功。
高级选项
- 排除文件：使用排除特定文件，例如
jar cvf myapp.jar -C bin . '!com/example/Utils.class'。 - 压缩级别：通过
0(不压缩)到9(最高压缩)调整压缩率，默认为6，例如jar cvf0 myapp.jar -C bin .。 - 签名JAR文件：使用
jarsigner工具对JAR文件进行数字签名，确保安全性：jarsigner -keystore mykeystore.jks -storepass password myapp.jar alias_name
常见问题与解决方案
-
问题：运行
java -jar myapp.jar时提示“Failed to load Main-Class manifest attribute”。 解决方案：检查MANIFEST.MF文件是否正确包含Main-Class属性，且属性值与主类的全限定名一致（如com.example.Main），确保JAR打包时通过m选项指定了清单文件。 -
问题：JAR文件运行时提示“ClassNotFoundException”。 解决方案：检查
jar tf myapp.jar命令输出，确认依赖的.class文件或资源文件是否已正确包含在JAR中，若依赖外部库，需使用Class-Path属性在MANIFEST.MF中指定路径（如Class-Path: lib/*.jar）,并将依赖库放在指定目录下。
（图片来源网络，侵删）
相关问答FAQs
Q1: 如何在JAR文件中包含第三方依赖库？
A1: 若需将第三方JAR库（如mysql-connector-java.jar）打包到主JAR中，可使用以下方法：
- 将依赖库放入
lib目录。 - 使用
jar工具将依赖库与主程序一同打包：jar cvf myapp.jar -C bin . -C resources . -C lib .
- 在
MANIFEST.MF中添加Class-Path属性指向依赖库（若不打包进主JAR，则需将依赖库放在运行目录下）。
Q2: 如何创建多模块项目的可执行JAR文件？
A2: 对于多模块项目（如Maven/Gradle项目），建议使用构建工具（如Maven的maven-assembly-plugin或Gradle的Shadow插件）自动合并依赖，若需手动操作，可按以下步骤：
- 分别编译各模块并生成JAR文件。
- 使用
jar工具合并所有JAR文件：jar cvf myapp.jar -C module1/bin . -C module2/bin . -C resources .
- 确保主类的
MANIFEST.MF配置正确,且依赖模块的类路径已包含在最终JAR中。
