C#实现ZIP文件压缩与解压的完整指南-代码聚汇网

C#实现ZIP文件压缩与解压的完整指南

weixin_29200485

1. 项目概述

在C#开发中，经常需要处理文件压缩的需求。Windows系统自带的ZIP功能为我们提供了便捷的解决方案，无需依赖第三方库就能实现文件夹打包。本文将详细介绍如何使用C#调用Windows原生功能完成ZIP压缩操作。

2. 核心实现原理

2.1 System.IO.Compression命名空间

.NET Framework 4.5及以上版本和.NET Core都内置了System.IO.Compression命名空间，其中包含处理ZIP文件的核心类：

ZipFile：提供创建、提取和操作ZIP存档的主要方法
ZipArchive：表示ZIP存档中的条目集合
ZipArchiveEntry：表示ZIP存档中的单个文件

2.2 依赖项配置

在开始编码前，需要确保项目已添加必要的引用：

对于.NET Core/.NET 5+项目：

bash复制dotnet add package System.IO.Compression.ZipFile

对于.NET Framework项目，需在引用管理器中添加：

System.IO.Compression
System.IO.Compression.FileSystem

3. 完整实现步骤

3.1 基础压缩功能实现

最简单的文件夹压缩只需两行代码：

csharp复制using System.IO.Compression;

string sourceFolder = @"C:\MyFolder";
string zipFilePath = @"C:\Archive.zip";

ZipFile.CreateFromDirectory(sourceFolder, zipFilePath);

3.2 进阶压缩选项

3.2.1 压缩级别控制

.NET提供了三种压缩级别：

csharp复制ZipFile.CreateFromDirectory(sourceFolder, zipFilePath, CompressionLevel.Optimal, includeBaseDirectory: false);

Optimal：最佳压缩（默认）
Fastest：快速压缩
NoCompression：仅存储不压缩

3.2.2 排除基目录

includeBaseDirectory参数控制是否包含源文件夹本身：

true：压缩包内包含源文件夹
false：仅压缩文件夹内容

3.3 解压缩实现

解压ZIP文件同样简单：

csharp复制string extractPath = @"C:\ExtractFolder";
ZipFile.ExtractToDirectory(zipFilePath, extractPath);

4. 高级应用场景

4.1 增量更新ZIP文件

csharp复制using (FileStream zipToOpen = new FileStream(zipFilePath, FileMode.Open))
{
    using (ZipArchive archive = new ZipArchive(zipToOpen, ZipArchiveMode.Update))
    {
        // 添加新文件
        ZipArchiveEntry newEntry = archive.CreateEntry("NewFile.txt");
        using (StreamWriter writer = new StreamWriter(newEntry.Open()))
        {
            writer.WriteLine("新增内容");
        }
        
        // 更新已有文件
        ZipArchiveEntry existingEntry = archive.GetEntry("ExistingFile.txt");
        using (StreamWriter writer = new StreamWriter(existingEntry.Open()))
        {
            writer.WriteLine("更新内容");
        }
    }
}

4.2 选择性压缩特定文件类型

csharp复制using (ZipArchive archive = ZipFile.Open(zipFilePath, ZipArchiveMode.Create))
{
    foreach (string file in Directory.GetFiles(sourceFolder, "*.pdf"))
    {
        archive.CreateEntryFromFile(file, Path.GetFileName(file));
    }
}

5. 安全注意事项

5.1 路径安全检查

解压时必须验证目标路径，防止目录遍历攻击：

csharp复制string extractPath = Path.GetFullPath(extractPath);
if (!extractPath.EndsWith(Path.DirectorySeparatorChar.ToString()))
    extractPath += Path.DirectorySeparatorChar;

using (ZipArchive archive = ZipFile.OpenRead(zipFilePath))
{
    foreach (ZipArchiveEntry entry in archive.Entries)
    {
        string destinationPath = Path.GetFullPath(Path.Combine(extractPath, entry.FullName));
        if (destinationPath.StartsWith(extractPath, StringComparison.Ordinal))
            entry.ExtractToFile(destinationPath);
    }
}

5.2 异常处理

必须处理可能出现的异常：

DirectoryNotFoundException
IOException
UnauthorizedAccessException
InvalidDataException（损坏的ZIP文件）

6. 性能优化技巧

6.1 大文件处理

处理大文件时建议使用流式操作：

csharp复制using (FileStream zipToCreate = new FileStream(zipFilePath, FileMode.Create))
{
    using (ZipArchive archive = new ZipArchive(zipToCreate, ZipArchiveMode.Create))
    {
        ZipArchiveEntry entry = archive.CreateEntry("LargeFile.bin");
        using (Stream entryStream = entry.Open())
        using (FileStream fileStream = File.OpenRead(@"C:\LargeFile.bin"))
        {
            fileStream.CopyTo(entryStream);
        }
    }
}

6.2 并行压缩

对于大量小文件可使用并行处理：

csharp复制var files = Directory.GetFiles(sourceFolder);
Parallel.ForEach(files, file => {
    using (ZipArchive archive = ZipFile.Open(zipFilePath, ZipArchiveMode.Update))
    {
        archive.CreateEntryFromFile(file, Path.GetFileName(file));
    }
});

7. 实际应用案例

7.1 日志文件自动归档

csharp复制public void ArchiveLogs(string logFolder, int daysToKeep)
{
    string zipName = $"Logs_{DateTime.Now:yyyyMMdd}.zip";
    string[] oldLogs = Directory.GetFiles(logFolder, "*.log")
        .Where(f => (DateTime.Now - File.GetCreationTime(f)).TotalDays > daysToKeep)
        .ToArray();
    
    using (ZipArchive archive = ZipFile.Open(Path.Combine(logFolder, zipName), ZipArchiveMode.Create))
    {
        foreach (string log in oldLogs)
        {
            archive.CreateEntryFromFile(log, Path.GetFileName(log));
            File.Delete(log);
        }
    }
}

7.2 网站静态资源打包

csharp复制public void BundleWebAssets(string wwwrootPath)
{
    string[] assetTypes = { "*.css", "*.js", "*.png" };
    string bundlePath = Path.Combine(wwwrootPath, "assets.zip");
    
    using (ZipArchive archive = ZipFile.Open(bundlePath, ZipArchiveMode.Create))
    {
        foreach (string type in assetTypes)
        {
            foreach (string file in Directory.GetFiles(Path.Combine(wwwrootPath, "static"), type))
            {
                string relativePath = Path.GetRelativePath(wwwrootPath, file);
                archive.CreateEntryFromFile(file, relativePath);
            }
        }
    }
}

8. 常见问题解决

8.1 "Could not find EOCD"错误

此错误通常表示ZIP文件损坏。解决方法：

检查文件完整性
尝试使用不同的解压工具验证
重新下载或获取文件副本

8.2 内存不足问题

处理特大ZIP文件时可能遇到内存不足，解决方案：

使用流式处理而非一次性加载
增加GC内存限制
分批处理文件

8.3 中文文件名乱码

确保使用UTF-8编码：

csharp复制using (ZipArchive archive = ZipFile.Open(zipFilePath, ZipArchiveMode.Create))
{
    var entry = archive.CreateEntry("中文文件.txt");
    // 写入内容...
}

9. 替代方案比较

9.1 DotNetZip库

特点：

更丰富的功能（密码保护、AES加密等）
更好的性能
需要额外安装NuGet包

9.2 SharpZipLib

特点：

支持更多压缩格式
跨平台兼容性更好
学习曲线较陡

9.3 Windows原生方案优势

无需额外依赖
与系统深度集成
维护性好

10. 最佳实践建议

始终验证输入路径
处理完成后释放所有资源
对大文件操作提供进度反馈
考虑实现断点续传功能
记录压缩操作的详细日志

通过本文介绍的方法，您可以在C#项目中轻松实现高效的文件夹压缩功能。根据实际需求选择合适的压缩级别和方案，既能满足功能需求，又能保证良好的性能表现。