Java中用JarOutputStream打包JAR文件，本质是向ZIP流写入符合JAR规范的条目（JarEntry）并可选添加META-INF/MANIFEST.MF；必须显式设置JarEntry时间戳（如entry.setTime(System.currentTimeMillis())），否则部分JDK版本使用1980-01-01默认值导致解压失败；MANIFEST.MF必须作为第一个条目写入，即先putNextEntry(new JarEntry("META-INF/MANIFEST.MF"))再manifest.write(jarOut)；资源路径须用正斜杠/且不以/开头，目录项以/结尾（如"com/example/"）；每个putNextEntry()后必须调用closeEntry()，整体推荐try-with-resources确保流正确关闭。
Java 中用 JarOutputStream 打包 JAR 文件，本质是往 ZIP 格式流中写入符合 JAR 规范的条目（JarEntry），并可选添加 META-INF/MANIFEST.MF。关键不在“压缩”，而在“正确构造条目结构和元信息”。
必须设置 JarEntry 的时间戳
JarOutputStream 对条目时间戳敏感：若未显式设置，部分 JDK 版本会用默认值（如 1980-01-01），导致解压工具报错或校验失败。安全做法是统一设为当前时间或固定可信时间。
- 调用
entry.setTime(System.currentTimeMillis()) - 或使用确定值避免构建差异：
entry.setTime(1717027200000L)（例如 2024-05-30）
Manifest 要在第一个 entry 写入前写入
JAR 规范要求 META-INF/MANIFEST.MF 必须是归档中第一个条目。否则某些运行环境（如 Java Web Start 或旧版 ClassLoader）可能忽略它。
- 先创建
new JarEntry("META-INF/MANIFEST.MF") - 调用
jarOut.putNextEntry(entry) - 再用
manifest.write(jarOut)写入内容 - 最后
jarOut.closeEntry()
普通资源文件需按路径规范构造 JarEntry
JAR 中路径分隔符必须为正斜杠 /，且不能以 / 开头；目录条目要以 / 结尾（如 "com/example/"），但通常可省略——JAR 工具会自动推导。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
- 正确：
new JarEntry("com/example/MyClass.class") - 错误：
new JarEntry("\com\example\MyClass.class")或new JarEntry("/com/example/MyClass.class") - 目录项非必需，但显式添加可提升兼容性（尤其含空包时）
别忘了 closeEntry() 和 finally 确保关闭
每个 putNextEntry() 后必须配对 closeEntry()，否则内容可能截断；流本身也要确保关闭，推荐 try-with-resources。
- 写完一个 entry 后立即
jarOut.closeEntry() - 整个流程用
try (JarOutputStream jos = new JarOutputStream(...)) { ... } - 避免手动调用
jos.flush()——closeEntry()和close()已隐含刷新
基本上就这些。JarOutputStream 不复杂，但细节容易忽略，尤其是时间戳和 MANIFEST 位置。按规范走，打出来的 JAR 就能被 JVM 正常加载和验证。
