jar

Java 归档打包工具

补充说明

jar 创建、查看和解压 JAR 文件。JAR 本质是 ZIP，加上 META-INF/MANIFEST.MF 清单；它不会自动把依赖打进去，也不是构建工具。

常用示例

jar --create --file app.jar -C out .
jar --create --file app.jar --main-class com.example.Main -C out .
jar --list --file app.jar
jar --extract --file app.jar
jar --update --file app.jar -C resources .
jar tf app.jar
jar xf app.jar

易错点与排错

• 默认不会生成可执行 JAR；需要 --main-class 或手写 Main-Class 清单。
• -C out . 只打包 out 目录内容；直接写目录名可能把目录层级带进去。
• JAR 不是 fat jar；依赖缺失时运行报 NoClassDefFoundError。
• 清单里的 Class-Path 是相对路径，换目录后可能失效。
• 签名 JAR 修改后签名会失效；重新打包后要重新签。
• 可复现构建要固定时间戳和文件顺序，否则每次产物哈希不同。
• 多版本 JAR（META-INF/versions）需要正确的清单配置，普通打包不会自动生成。
• 解压不可信 JAR 前先检查路径穿越和覆盖风险。

相关命令

• java — 运行 JAR
• javac — 编译源码
• mvn / gradle — 构建可执行包