Java如何压缩空文件夹？

在Java中压缩文件夹时,一个常见挑战是空文件夹默认不会被包含在压缩文件中，这是因为java.util.zip库基于文件数据流工作，而空文件夹没有实际文件内容，以下是两种经过验证的解决方案，完整保留文件夹结构：

方法1：添加临时标记文件（无需第三方库）

核心思路：遍历文件夹时，在空目录中生成临时标记文件（压缩后自动删除），确保文件夹结构被保留。

import java.io.*;
import java.nio.file.*;
import java.util.zip.*;
public class FolderCompressor {
    // 创建临时标记文件（隐藏文件）
    private static void createPlaceholderFile(File dir) throws IOException {
        File placeholder = new File(dir, ".keep"); // 标记文件名
        if (!placeholder.exists()) {
            placeholder.createNewFile();
            placeholder.deleteOnExit(); // 程序退出时删除
        }
    }
    // 递归压缩文件夹（含空目录）
    public static void zipFolder(File sourceDir, File outputZip) throws IOException {
        try (ZipOutputStream zos = new ZipOutputStream(new FileOutputStream(outputZip))) {
            addFolderToZip(sourceDir, sourceDir, zos);
        }
    }
    private static void addFolderToZip(File rootDir, File currentDir, ZipOutputStream zos) throws IOException {
        File[] files = currentDir.listFiles();
        if (files == null || files.length == 0) {
            createPlaceholderFile(currentDir); // 空目录创建标记文件
            files = currentDir.listFiles();    // 重新加载文件列表
        }
        for (File file : files) {
            if (file.isDirectory()) {
                addFolderToZip(rootDir, file, zos); // 递归子目录
                continue;
            }
            String relativePath = rootDir.toPath().relativize(file.toPath()).toString();
            zos.putNextEntry(new ZipEntry(relativePath));
            try (FileInputStream fis = new FileInputStream(file)) {
                byte[] buffer = new byte[1024];
                int length;
                while ((length = fis.read(buffer)) > 0) {
                    zos.write(buffer, 0, length);
                }
            }
            zos.closeEntry();
        }
    }
    // 使用示例
    public static void main(String[] args) throws IOException {
        File sourceDir = new File("path/to/folder");
        File zipOutput = new File("output.zip");
        zipFolder(sourceDir, zipOutput);
        System.out.println("压缩完成，空文件夹已保留！");
    }
}

关键点解析：

1. createPlaceholderFile() 在空目录创建隐藏文件 .keep（文件名可自定义）
2. deleteOnExit() 确保程序退出时自动清理临时文件
3. relativize() 方法保持压缩包内的相对路径结构
4. 递归处理嵌套目录,兼容任意深度的文件夹

优点：

• 纯Java标准库实现,零依赖
• 自动清理临时文件,无残留
• 100%保留原始目录结构

方法2：使用Apache Commons Compress（推荐生产环境）

第三方库能更优雅地处理空文件夹,特别适合复杂场景。

步骤1：添加Maven依赖

<dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-compress</artifactId>
    <version>1.25.0</version>
</dependency>

步骤2：实现压缩代码

import org.apache.commons.compress.archivers.zip.*;
import java.io.*;
import java.nio.file.*;
public class AdvancedFolderCompressor {
    public static void compressWithEmptyDirs(File sourceDir, File zipFile) throws IOException {
        try (ZipArchiveOutputStream zos = new ZipArchiveOutputStream(zipFile)) {
            addToZip(sourceDir, "", zos);
        }
    }
    private static void addToZip(File file, String basePath, ZipArchiveOutputStream zos) throws IOException {
        String entryName = basePath + file.getName();
        if (file.isDirectory()) {
            // 关键：为目录创建ZipArchiveEntry
            if (!entryName.endsWith("/")) entryName += "/";
            zos.putArchiveEntry(new ZipArchiveEntry(entryName));
            zos.closeArchiveEntry();
            // 递归处理子项
            for (File child : file.listFiles()) {
                addToZip(child, entryName, zos);
            }
        } else {
            ZipArchiveEntry entry = new ZipArchiveEntry(file, entryName);
            zos.putArchiveEntry(entry);
            try (FileInputStream fis = new FileInputStream(file)) {
                fis.transferTo(zos);
            }
            zos.closeArchiveEntry();
        }
    }
    // 使用示例
    public static void main(String[] args) throws IOException {
        File dir = new File("data/project");
        compressWithEmptyDirs(dir, new File("project.zip"));
    }
}

技术优势：

• 原生支持目录条目：通过entryName += "/"显式标记目录
• 自动处理路径分隔符,跨平台兼容（Windows/Linux）
• 支持压缩加密、分卷等高级功能
• 性能优化：处理大文件效率更高

两种方案对比

注意事项

1. 路径分隔符问题：Unix系统用，Windows用，建议用File.separator动态适配
2. 权限保留：如需保留文件权限，推荐使用java.nio.file.attribute
3. 符号链接：压缩前检查Files.isSymbolicLink(path)，避免循环引用
4. 内存管理：压缩超大目录时，用try-with-resources确保流关闭

保留空文件夹的关键在于显式标识目录结构，对于简单需求，临时文件方案足够轻量；若追求健壮性和扩展性，Apache Commons Compress是更优选择，实际开发中建议：

• 测试边缘案例（如嵌套空目录、特殊字符路径）
• 添加异常处理（ZipException, AccessDeniedException）
• 结合Files.walkFileTree()优化文件遍历

引用说明：

1. Java ZIP API 官方文档：java.util.zip 规范
2. Apache Commons Compress 官方指南：Apache Commons Compress
3. NIO.2 文件操作规范：Java NIO File API