Java ZIP 文件系统怎样在打开时创建不存在的归档

我第一次用 Java NIO 写 ZIP 归档时，容易把“创建压缩文件”和“打开 ZIP 文件系统”混成两个步骤。实际只要准备一个 jar: URI，再把环境参数 create 设为 true，FileSystems.newFileSystem 就能在目标文件不存在时创建它；后续写入仍然使用熟悉的 Path 和 Files。

官方地址：https://docs.oracle.com/en/java/javase/25/docs/api/jdk.zipfs/module-summary.html

关键写法是 URI.create("jar:" + zipPath.toUri()) 加上 Map.of("create", "true")。不要把 accessMode 设成 readOnly，也要让 FileSystem 正常关闭，归档才会完成写入。

先把本地路径转换成 ZIP 文件系统地址

ZIP 文件系统的识别 scheme 是 jar。用 Path.toUri() 处理绝对路径，比手写 file:/ 更稳，也能减少路径中空格或平台分隔符带来的问题。

import java.net.URI;
import java.nio.file.Path;

Path zipPath = Path.of("build", "report.zip").toAbsolutePath();
// 用 jar scheme 标记 ZIP 文件系统，避免手写平台相关的 file URI。
URI zipUri = URI.create("jar:" + zipPath.toUri());

这里的 zipPath 只是归档在宿主文件系统中的位置；真正写入条目时，要使用新文件系统返回的路径，不能把宿主路径直接当成 ZIP 内部路径。

用 create=true 打开不存在的归档

创建 ZIP 文件系统时传入环境 Map。官方 ZIP provider 的 create 默认是 false，设为 true 后，如果目标 ZIP 或 JAR 不存在，provider 会创建它。下面的例子同时创建内部目录并写入一个文本条目。

import java.net.URI;
import java.nio.charset.StandardCharsets;
import java.nio.file.FileSystem;
import java.nio.file.FileSystems;
import java.nio.file.Files;
import java.nio.file.Path;
import java.util.Map;

Path zipPath = Path.of("build", "report.zip").toAbsolutePath();
URI zipUri = URI.create("jar:" + zipPath.toUri());
Map env = Map.of("create", "true");

// try-with-resources 会在写入结束后关闭 ZIP 文件系统，提交归档内容。
try (FileSystem zipfs = FileSystems.newFileSystem(zipUri, env)) {
    Path entry = zipfs.getPath("/reports/summary.txt");
    // ZIP 内部目录可能尚不存在，先创建父目录再写文件。
    Files.createDirectories(entry.getParent());
    Files.writeString(entry, "daily summary\n", StandardCharsets.UTF_8);
}

运行这段代码后，build/report.zip 是宿主文件系统中的归档，/reports/summary.txt 是 ZIP 内部条目。示例中的英文内容只是归档载荷，实际项目可替换成 JSON、日志或导出的报表。

创建、追加和只读要分开配置

这个参数组合最容易在维护代码时被误改。新建归档或需要写入已有归档时，保持可写；只读检查则不要传 create=true。如果明确传入 accessMode，readOnly 要求底层 ZIP 已经存在，而 readWrite 在不能写时会抛出 IOException。

我更倾向于显式区分“生成任务”和“检查任务”：生成任务拥有写权限，结束时关闭 FileSystem；检查任务用只读模式，避免排查代码意外改写归档。

为什么关闭时机决定归档是否可用

FileSystem 是 ZIP provider 对归档的写入边界。把文件写入完成并不等于宿主文件已经处于最终状态，应该让 try-with-resources 负责关闭它。不要在 try 外继续使用 zipfs.getPath() 得到的路径，也不要在关闭前把任务当成已完成。

// 关闭后再把归档交给上传或后续任务，避免读取到未完成的写入状态。
Files.size(zipPath);
System.out.println("ZIP ready: " + zipPath);

如果目录创建或条目写入失败，异常会在 try 块内暴露；如果关闭阶段出现写入错误，try-with-resources 也会把关闭异常带回调用方。生产代码应记录归档路径并保留原始异常，不要只打印一个“成功”提示。

常见问题

只设置 create=true 还需要先创建空 ZIP 文件吗？

不需要。目标不存在时，ZIP provider 会按配置创建 ZIP 或 JAR 文件；提前手动创建空文件反而会让创建逻辑变得多余。

为什么 create=true 和 readOnly 不能一起用？

因为创建需要写入底层归档，而只读模式要求底层 ZIP 已存在且不可写，两者语义冲突，官方实现会拒绝这种组合。

ZIP 内部路径应该从哪里取得？

使用 zipfs.getPath("/目录/文件")，不要把宿主文件系统的 zipPath.resolve(...) 当成内部条目路径。

把 jar: URI、create=true 和可控的关闭边界组合起来，就能用标准 NIO API 创建不存在的 ZIP 归档；剩下的重点是按任务区分可写和只读，而不是再额外维护一套压缩文件 API。