怎样用Java操作ZIP文件？压缩解压完整教程-java教程-PHP中文网

怎样用Java操作ZIP文件？压缩解压完整教程

看不見的法師

发布： 2025-07-06 16:28:01

原创

940人浏览过

java通过标准库可实现zip文件压缩与解压。具体步骤如下：1. 压缩文件或文件夹使用zipoutputstream，创建fileoutputstream并递归遍历文件目录，每个文件创建zipentry写入内容；2. 解压使用zipinputstream逐个读取条目，区分文件和目录分别处理并保存至目标路径；3. 注意事项包括路径拼接使用相对路径、设置编码以避免乱码、控制压缩级别提升效率、防止重复压缩浪费性能及加强异常处理确保流程稳定。

怎样用Java操作ZIP文件？压缩解压完整教程

在Java开发中，处理ZIP文件是常见的需求，比如打包资源、上传下载、备份数据等。好在Java标准库（从JDK 1.6开始）已经提供了对ZIP格式的支持，通过 java.util.zip 包就可以完成压缩和解压操作，不需要额外依赖。

下面我们就来一步步看看怎么用Java实现ZIP文件的压缩和解压。

如何用Java压缩文件或文件夹？

要压缩一个文件或者整个目录，可以通过 Java 的 ZipOutputStream 类来实现。基本思路是遍历目标路径下的所有文件，然后一个个写入 ZIP 输出流中。

立即学习“Java免费学习笔记（深入）”；

具体步骤如下：

创建输出 ZIP 文件的 FileOutputStream
使用该流创建 ZipOutputStream
遍历文件目录，递归添加每个文件到 ZIP 中
每个文件都要创建对应的 ZipEntry 并写入内容

public static void zipFolder(File sourceFolder, File targetZip) throws IOException {
    try (FileOutputStream fos = new FileOutputStream(targetZip);
         ZipOutputStream zos = new ZipOutputStream(fos)) {

        zipFile(sourceFolder, sourceFolder.getName(), zos);
    }
}

private static void zipFile(File fileToZip, String parentPath, ZipOutputStream zos) throws IOException {
    String zipEntryName = parentPath + "/" + fileToZip.getName();

    if (fileToZip.isDirectory()) {
        for (File childFile : Objects.requireNonNull(fileToZip.listFiles())) {
            zipFile(childFile, zipEntryName, zos);
        }
    } else {
        try (FileInputStream fis = new FileInputStream(fileToZip)) {
            ZipEntry zipEntry = new ZipEntry(zipEntryName);
            zos.putNextEntry(zipEntry);

            byte[] buffer = new byte[1024];
            int len;
            while ((len = fis.read(buffer)) > 0) {
                zos.write(buffer, 0, len);
            }
        }
    }
}

登录后复制

注意点：如果源路径是文件夹，记得递归处理子目录；路径拼接建议使用相对路径，避免绝对路径导致解压后结构混乱；压缩过程中务必关闭每个 ZipEntry，否则可能导致压缩失败。

怎么用Java解压ZIP文件？

如果你需要从ZIP包中提取文件，可以使用 ZipInputStream 和 ZipEntry 来逐个读取并保存文件。

核心逻辑：

打开 ZIP 文件输入流
读取每一个条目（ZipEntry）
如果是目录则创建对应文件夹
如果是文件就写入本地磁盘

public static void unzipFile(File zipFile, File destDir) throws IOException {
    byte[] buffer = new byte[1024];

    try (ZipInputStream zis = new ZipInputStream(new FileInputStream(zipFile))) {
        ZipEntry zipEntry = zis.getNextEntry();

        while (zipEntry != null) {
            File newFile = new File(destDir, zipEntry.getName());

            if (zipEntry.isDirectory()) {
                newFile.mkdirs();
            } else {
                newFile.getParentFile().mkdirs();
                try (FileOutputStream fos = new FileOutputStream(newFile)) {
                    int len;
                    while ((len = zis.read(buffer)) > 0) {
                        fos.write(buffer, 0, len);
                    }
                }
            }

            zipEntry = zis.getNextEntry();
        }
    }
}

登录后复制

常见问题提醒：

解压时如果路径中有特殊字符或深度嵌套，可能报错，最好提前检查路径合法性；

注意区分 ZIP 条目是文件还是目录，否则容易漏掉某些文件；

解压完成后别忘了关闭流，可以用 try-with-resources 自动管理。

还有哪些需要注意的地方？

虽然上面的方法已经能满足大部分场景，但实际开发中还有一些细节值得留意：

编码问题： 默认情况下，Java 使用平台默认编码处理 ZIP 文件名。如果是 UTF-8 编码的 ZIP（例如 WinRAR 或 Mac 打包的），需要指定编码方式：
```
ZipInputStream zis = new ZipInputStream(new FileInputStream(zipFile), StandardCharsets.UTF_8);
```
登录后复制
压缩级别设置： 如果你希望控制压缩率，可以在创建 ZipOutputStream 后设置压缩级别：
```
zos.setLevel(Deflater.BEST_COMPRESSION); // 最高压缩
```
登录后复制
避免重复压缩： 如果某个文件已经被压缩过，再次压缩可能收益不大，反而浪费性能；
异常处理： 实际项目中一定要加 try-catch，防止因为个别文件损坏导致整个压缩/解压流程中断。