Java 的 java.nio.file.Path 默认受限于操作系统文件系统规则，无法解析 ZIP 内部含 | 等非法字符的路径；正确做法是通过 JDK 内置的 ZIP 文件系统（jdk.zipfs）挂载 ZIP 为虚拟文件系统，再使用其 Path 实例——它遵循 ZIP 规范而非 OS 文件系统约束。
java 的 `java.nio.file.path` 默认受限于操作系统文件系统规则，无法解析 zip 内部含 `|` 等非法字符的路径；正确做法是通过 jdk 内置的 zip 文件系统（`jdk.zipfs`）挂载 zip 为虚拟文件系统，再使用其 `path` 实例——它遵循 zip 规范而非 os 文件系统约束。
在处理 ZIP 归档内部路径时，直接调用 Paths.get("a|b.txt") 会抛出 InvalidPathException，因为 Paths.get() 始终基于默认文件系统（即当前 OS 的本地文件系统），而 | 在 Windows 上是保留字符，在 POSIX 系统中虽非保留但 Path 实现仍可能拒绝解析。此时强行绕过校验（如自定义字符串解析逻辑）将丧失 Path 接口的语义优势——例如 getParent()、resolve()、relativize() 等方法将无法可靠工作。
✅ 正确方案：使用 JDK 自带的 ZIP 文件系统提供者（jdk.zipfs 模块）。该实现将 ZIP 文件视为一个只读（或可写）的虚拟文件系统，其 Path 对象完全遵循 ZIP 格式规范（APPNOTE.txt），允许路径中包含 /, \, |, *, ?, , <code>>, :, " 等在 OS 中非法但在 ZIP 中合法的字符。
以下是一个完整示例，展示如何安全遍历 ZIP 内部路径并执行路径操作：
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
import java.io.IOException;
import java.nio.file.*;
import java.nio.file.attribute.BasicFileAttributes;
import java.util.stream.Stream;
public class ZipPathExample {
public static void listZipContents(String zipPath) throws IOException {
try (FileSystem fs = FileSystems.newFileSystem(Path.of(zipPath))) {
// 获取 ZIP 根目录（通常为 "/"）
Path root = fs.getPath("/");
// 使用 Files.walk() 安全遍历所有条目（自动适配 ZIP 路径语义）
try (Stream<Path> paths = Files.walk(root)) {
paths.filter(Files::isRegularFile)
.forEach(path -> {
System.out.println("File: " + path);
System.out.println(" Parent: " + path.getParent());
System.out.println(" Name count: " + path.getNameCount());
System.out.println(" Filename: " + path.getFileName());
System.out.println(" Relative to root: " + root.relativize(path));
});
}
}
}
public static void main(String[] args) throws IOException {
listZipContents("example.zip"); // 包含 "dir|sub/a|b.txt" 等路径
}
}⚠️ 注意事项：
立即学习“Java免费学习笔记（深入）”；
-
jdk.zipfs自 Java 7 起内置，无需额外依赖；但需确保模块可用（Java 9+ 模块化环境下建议显式添加--add-modules jdk.zipfs）； -
FileSystem实例是重量级资源，必须显式关闭（推荐try-with-resources）； - ZIP 文件系统默认为只读；如需写入，需传入
Map<string string> env = Map.of("create", "true")</string>并确保 ZIP 可写； - 不要混用
Paths.get()创建的Path与 ZIP 文件系统的Path——二者属于不同FileSystem，互不兼容； - 若仅需轻量级路径解析（无 I/O），且确定 ZIP 路径仅含
/分隔符，可考虑java.nio.file.Paths.get(URI.create("jar:file:/path/to.zip!/a|b.txt"))，但该方式仍依赖 ZIP FS 加载，本质同上。
总结：java.nio.file.Path 本身并非“错误选择”，而是必须配合正确的 FileSystem 实现。对于 ZIP 内容路径，请始终优先使用 FileSystems.newFileSystem(...) 创建专属文件系统，让 Path 在语义一致的上下文中工作——这才是符合 NIO.2 设计哲学的健壮实践。
