ZipArchiveEntry.ExtractToFile兼容WinRAR压缩包但不兼容MSBuild压缩包问题

你遇到的问题大概率不是System.IO.Compression的bug，而是WinRAR和MSBuild ZipDirectory任务在打包目录时的策略差异导致的，以下是几个关键遗漏点和解决办法：

核心差异点 #

• 目录条目处理不同：WinRAR手动打包时，会把每个子文件夹单独作为一个ZipArchiveEntry（空目录也会生成条目），解压时这些目录条目会先创建好文件夹，后续文件解压自然不会报错。但MSBuild的ZipDirectory默认不会生成空目录的条目，对于非空目录，也不会单独创建目录条目，只包含目录下的文件条目。
• ExtractToFile的行为限制：ZipArchiveEntry.ExtractToFile方法本身不会自动创建目标文件的父目录，如果父目录不存在，就会抛出DirectoryNotFoundException。WinRAR的压缩包因为提前创建了目录，所以没触发这个问题，而MSBuild生成的压缩包直接解压文件时就会报错。

解决办法 #

在解压每个条目之前，手动创建目标路径的父目录即可，两种实现方式：

方式1：统一创建父目录 #

不管条目是文件还是目录，先确保父目录存在：

using (ZipArchive archive = ZipFile.OpenRead(zipFilePath))
{
    foreach (ZipArchiveEntry entry in archive.Entries)
    {
        string destinationPath = Path.Combine(extractDirectory, entry.FullName);
        // 先创建目标文件的父目录
        Directory.CreateDirectory(Path.GetDirectoryName(destinationPath));
        entry.ExtractToFile(destinationPath, overwrite: true);
    }
}

方式2：区分目录和文件条目 #

有些压缩包中，目录条目会以路径分隔符结尾且Name属性为空，可以先处理目录条目创建文件夹，再处理文件：

using (ZipArchive archive = ZipFile.OpenRead(zipFilePath))
{
    foreach (ZipArchiveEntry entry in archive.Entries)
    {
        string destinationPath = Path.Combine(extractDirectory, entry.FullName);
        // 判断是否为目录条目
        if (string.IsNullOrWhiteSpace(entry.Name))
        {
            Directory.CreateDirectory(destinationPath);
            continue;
        }
        // 创建文件的父目录
        Directory.CreateDirectory(Path.GetDirectoryName(destinationPath));
        entry.ExtractToFile(destinationPath, overwrite: true);
    }
}

补充说明 #

这种差异是不同压缩工具的设计选择，不是.NET类库的bug。ExtractToFile的文档明确说明需要确保目标路径的父目录存在，所以在自定义解压方法时，必须手动处理目录创建逻辑，才能兼容不同工具生成的压缩包。

内容的提问来源于stack exchange，提问作者Pawcio