C# 文件压缩与解压缩实用教程

最新推荐文章于 2025-09-22 10:37:04 发布

原创最新推荐文章于 2025-09-22 10:37:04 发布 · 1k 阅读

CC 4.0 BY-SA版权

简介：C#编程中，实现文件和文件夹的压缩与解压缩是一项基础任务，特别在处理大量数据时尤为关键。本文将深入介绍如何使用C#在Visual Studio 2010环境下进行文件压缩解压操作。通过.NET Framework的 System.IO.Compression 命名空间中的 ZipArchive 类，开发者可以方便地实现压缩文件的创建、读取和修改功能。文章将展示如何压缩和解压缩文件夹，以及在操作过程中处理异常和提供用户进度反馈的重要性。

1. C#文件压缩与解压基础

在现代软件开发中，文件压缩和解压功能是不可或缺的。文件压缩技术使得我们可以高效地管理和传输大量数据，而解压功能则确保了压缩文件能够便捷地恢复到原始状态。C#作为一种强大的编程语言，提供了丰富的类库来实现这些功能，使得开发者能够在应用程序中轻松集成文件压缩与解压能力。在本章中，我们将介绍C#文件压缩和解压的基本概念，为后续章节中深入探讨System.IO.Compression命名空间和ZipArchive类等高级功能打下坚实的基础。通过理解这些基础知识，开发者可以更好地掌握文件压缩与解压的相关技术，并在实际项目中应用。

2. 使用System.IO.Compression命名空间

2.1 System.IO.Compression命名空间概述

2.1.1 命名空间的作用与优势

在处理文件压缩与解压任务时， System.IO.Compression 命名空间为.NET开发者提供了一套功能丰富的API集合。该命名空间允许在.NET应用程序中轻松地创建和提取ZIP存档，同时提供了对GZIP文件的压缩和解压功能。相较于其他第三方库，该命名空间的优势主要体现在原生支持和语言兼容性上，减少了对外部依赖的需要，并且能够无缝融入.NET框架的生态系统中。

2.1.2 环境配置与引入命名空间

要使用 System.IO.Compression 命名空间中的类，首先确保你的开发环境至少是.NET Framework 4.5或.NET Core。在项目中引入命名空间非常简单，只需要在文件的顶部添加以下using指令：

using System.IO.Compression;

这之后，你就可以访问 ZipArchive 和 ZipArchiveEntry 等类来执行压缩和解压缩操作了。例如，创建一个ZIP存档的基本代码结构将如下所示：

using System.IO.Compression;
using System.IO;

public class ZipExample
{
    public void CreateZipArchive(string archivePath, string folderPath)
    {
        using (FileStream zipToOpen = new FileStream(archivePath, FileMode.Create))
        {
            using (ZipArchive archive = new ZipArchive(zipToOpen, ZipArchiveMode.Create))
            {
                // 循环遍历文件夹中的所有文件
                foreach (var file in Directory.GetFiles(folderPath))
                {
                    archive.CreateEntryFromFile(file, Path.GetFileName(file));
                }
            }
        }
    }
}

2.2 命名空间中的核心类介绍

2.2.1 ZipArchive类的角色与功能

ZipArchive 类是 System.IO.Compression 命名空间的核心之一，用于表示一个ZIP存档。它可以创建新的ZIP存档，或者打开一个现有的ZIP文件。通过 ZipArchive 类，开发者可以添加新的文件条目到存档中，或者从中读取已存在的条目。

ZipArchive类的实例化通常发生在创建一个新的ZIP文件或打开一个现有的ZIP文件时。创建新的ZIP文件通常涉及 FileStream 类，因为它提供了一个文件流，ZipArchive需要这个流来写入ZIP格式的数据。

2.2.2 ZipArchiveEntry类的作用

ZipArchiveEntry 类表示ZIP存档中的单个文件条目。它允许开发者设置条目的属性，例如文件名、压缩大小、未压缩大小、压缩方法以及是否加密等。当向ZIP存档中添加文件时，ZipArchive会自动创建一个ZipArchiveEntry实例。

该类还允许对存储在ZIP存档中的文件进行操作，比如读取文件内容或更改文件属性。使用ZipArchiveEntry类，开发者可以将单个文件添加到存档中，或者从存档中提取文件。

一个简单的代码示例展示了如何使用ZipArchiveEntry类来创建存档条目：

using System.IO.Compression;
using System.IO;

public class ZipEntryExample
{
    public void CreateZipEntry(string archivePath, string fileToZip)
    {
        using (FileStream zipToOpen = new FileStream(archivePath, FileMode.OpenOrCreate))
        {
            using (ZipArchive archive = new ZipArchive(zipToOpen, ZipArchiveMode.Update))
            {
                ZipArchiveEntry readmeEntry = archive.CreateEntry("Readme.txt");
                using (StreamWriter writer = new StreamWriter(readmeEntry.Open()))
                {
                    writer.WriteLine("This is a sample text added to the zip archive.");
                }
            }
        }
    }
}

本章节介绍了 System.IO.Compression 命名空间的基础知识，并通过代码示例展示了如何在.NET应用程序中实现文件的压缩和解压功能。接下来，我们将深入探讨 ZipArchive 类的实例化和使用，以及在操作中可能遇到的高级技巧。

3. ZipArchive类的实例化和使用

ZipArchive类是System.IO.Compression命名空间中的核心类之一，允许我们在C#中创建和处理ZIP文件。这一章节将深入探讨ZipArchive类的实例化方法以及如何使用它来处理压缩文件。我们将按照从基础到高级的顺序介绍相关知识。

3.1 ZipArchive类的基本操作

3.1.1 创建ZipArchive实例的方法

ZipArchive类提供了一种创建ZIP文件并进行操作的简便方式。要在C#中创建一个ZipArchive实例，我们首先需要打开一个Stream对象，该对象提供对ZIP文件的读写访问。以下是一个创建ZipArchive实例的示例代码：

using System.IO;
using System.IO.Compression;

public void CreateZipArchive(string zipFilePath, string[] filesToZip)
{
    using (FileStream zipToOpen = new FileStream(zipFilePath, FileMode.Create))
    {
        using (ZipArchive archive = new ZipArchive(zipToOpen, ZipArchiveMode.Create))
        {
            foreach (string file in filesToZip)
            {
                archive.CreateEntryFromFile(file, Path.GetFileName(file));
            }
        }
    }
}

在这个示例中， FileStream 对象用于打开或创建一个ZIP文件。 ZipArchiveMode.Create 指定了我们想要创建一个新的ZIP文件。然后， CreateEntryFromFile 方法将指定的文件添加到ZIP文件中。

3.1.2 ZipArchive类的基本方法介绍

ZipArchive类除了能创建ZIP文件外，还提供了以下基本方法：

CreateEntry(string entryName) ：在ZIP文件中创建一个新的ZipArchiveEntry实例。
CreateEntryFromFile(string sourceFileName, string entryName) ：从指定路径创建一个新的ZipArchiveEntry实例。
Dispose() ：在完成所有操作后，释放与ZipArchive关联的所有资源。

例如，创建一个新的ZipArchiveEntry实例来演示如何添加一个空的目录条目：

using (ZipArchive archive = ZipFile.Open("archive.zip", ZipArchiveMode.Update))
{
    archive.CreateEntry("empty_directory/");
}

这将添加一个名为“empty_directory/”的空目录条目到ZIP文件。

3.2 高级使用技巧

3.2.1 处理大型文件时的内存管理

当处理大型文件时，我们需要格外注意内存管理。ZipArchive类通过支持流式处理（streaming）的方式来优化内存使用。以下是如何在添加大型文件时最小化内存占用的示例：

using (ZipArchive archive = ZipFile.Open("archive.zip", ZipArchiveMode.Update))
{
    string largeFilePath = @"path\to\large\file.txt";
    using (Stream entryStream = archive.CreateEntryFromFile(largeFilePath, Path.GetFileName(largeFilePath)).Open())
    {
        using (FileStream fileStream = new FileStream(largeFilePath, FileMode.Open, FileAccess.Read))
        {
            fileStream.CopyTo(entryStream);
        }
    }
}

在这个示例中，使用 CopyTo 方法将大型文件的内容直接从一个文件流复制到另一个文件流中，而不是先将整个文件内容加载到内存中。

3.2.2 多线程环境下的ZipArchive应用

在多线程应用程序中使用ZipArchive类时，需要确保线程安全。对于读操作，ZipArchive是线程安全的。然而，如果多个线程尝试写入同一个ZIP文件，就必须手动进行同步：

object zipLock = new object();

public void AddFileToZipThreadSafe(ZipArchive archive, string filePath, string entryName)
{
    lock (zipLock)
    {
        archive.CreateEntryFromFile(filePath, entryName);
    }
}

在上面的代码中，我们使用了一个锁对象 zipLock 来确保一次只有一个线程可以向ZIP文件中添加文件。

在下一章节中，我们将进一步探讨如何压缩文件夹，包括设置压缩等级和使用密码保护压缩文件。

4. 压缩文件夹的方法

在当今数字化时代，文件压缩是数据管理和传输中的常见操作。它能够减小文件大小，便于存储和分享。C#作为强大的编程语言，提供了多种方法来实现文件夹的压缩。本章节将介绍如何使用C#对文件夹进行压缩，包括单个文件与整个文件夹的压缩，以及一些高级压缩技巧。

4.1 压缩单个文件与文件夹

4.1.1 实现单个文件的压缩

为了压缩单个文件，我们首先需要了解C#中 ZipArchive 类的 CreateEntryFromFile 方法。这个方法允许我们从一个现有的文件创建一个压缩条目。

以下是一个简单的示例代码，展示了如何压缩单个文件：

using System.IO;
using System.IO.Compression;

public class ZipFileExample
{
    public static void ZipSingleFile(string sourceFile, string destinationArchive)
    {
        using (var zipToOpen = new FileStream(destinationArchive, FileMode.Create))
        {
            using (var archive = new ZipArchive(zipToOpen, ZipArchiveMode.Create))
            {
                var entry = archive.CreateEntryFromFile(sourceFile, Path.GetFileName(sourceFile));
                // 可以对entry进行额外操作，例如设置压缩等级等
            }
        }
    }
}

这段代码首先创建了一个文件流 FileStream ，指向目标压缩文件 destinationArchive 。然后使用 ZipArchive 类来创建一个新的压缩存档，并通过 CreateEntryFromFile 方法将指定的 sourceFile 添加到压缩存档中。

参数说明与逻辑分析

FileStream 对象 zipToOpen 用于打开或创建指定的文件，并设置为创建模式 FileMode.Create 。
ZipArchive 对象 archive 基于 zipToOpen 创建，指定操作模式为 ZipArchiveMode.Create ，意味着我们要创建一个新的压缩存档。
CreateEntryFromFile 方法接受源文件路径和目标压缩文件中的条目名称作为参数，将文件添加到压缩存档中。
using 语句确保所有资源在使用完毕后都能被正确释放，避免资源泄漏。

4.1.2 实现整个文件夹的压缩

压缩整个文件夹相比单个文件要复杂一些，因为它涉及到文件和子文件夹的递归遍历。为了完成这一任务，我们可以使用 DirectoryInfo 和 FileInfo 类来遍历文件夹，并使用 ZipArchive 类来创建压缩条目。

以下是一个基本示例：

using System.IO;
using System.IO.Compression;

public class ZipFolderExample
{
    public static void ZipFolder(string sourceFolder, string destinationArchive)
    {
        var filesToZip = Directory.GetFiles(sourceFolder, "*.*", SearchOption.AllDirectories);
        using (var zipToOpen = new FileStream(destinationArchive, FileMode.Create))
        {
            using (var archive = new ZipArchive(zipToOpen, ZipArchiveMode.Create))
            {
                foreach (var file in filesToZip)
                {
                    var entryName = file.Substring(sourceFolder.Length + 1);
                    var zipEntry = archive.CreateEntry(entryName);
                    using (var entryStream = zipEntry.Open())
                    using (var fileStream = new FileStream(file, FileMode.Open, FileAccess.Read))
                    {
                        fileStream.CopyTo(entryStream);
                    }
                }
            }
        }
    }
}

这段代码使用 Directory.GetFiles 方法获取源文件夹 sourceFolder 下的所有文件（包括子文件夹中的文件）。然后对每一个文件，我们计算相对于源文件夹的路径，创建一个压缩条目，并将文件的内容复制到该压缩条目的流中。

参数说明与逻辑分析

Directory.GetFiles 方法接受源文件夹路径、通配符和搜索选项。 "*.*" 表示获取所有文件， SearchOption.AllDirectories 表示包括子文件夹。
遍历文件集合时， Substring 方法用于去除文件路径中源文件夹路径的部分，得到相对于源文件夹的文件路径。
对每个文件创建 ZipEntry ，并使用 FileStream 打开文件内容。
使用 CopyTo 方法将文件流的内容复制到压缩条目的流中。

4.2 高级压缩技巧

4.2.1 设置压缩等级

C#允许开发者通过设置 CompressionLevel 属性来指定压缩时的压缩等级。 CompressionLevel 定义了压缩算法优化的范围，它是一个枚举类型，包括 Fastest （最快）、 Optimal （优化）等选项。

示例代码与逻辑分析

using System.IO;
using System.IO.Compression;

public class AdvancedZipExample
{
    public static void SetCompressionLevel(string sourceFile, string destinationArchive)
    {
        CompressionLevel level = CompressionLevel.Fastest; // 设置压缩等级为最快

        using (var zipToOpen = new FileStream(destinationArchive, FileMode.Create))
        {
            using (var archive = new ZipArchive(zipToOpen, ZipArchiveMode.Create))
            {
                var entry = archive.CreateEntryFromFile(sourceFile, Path.GetFileName(sourceFile));
                entry.CompressionLevel = level;
            }
        }
    }
}

在这段代码中，我们创建了 CompressionLevel.Fastest ，意味着我们倾向于更快的压缩速度，即使这可能以牺牲压缩效率为代价。

4.2.2 使用密码保护压缩文件

有时我们需要对压缩文件进行加密保护，C#提供了使用 ZipArchive 类进行密码保护的选项。我们可以通过设置 ZipArchiveEntry 的 Password 属性来实现。

示例代码与逻辑分析

using System.IO;
using System.IO.Compression;

public class PasswordProtectedZipExample
{
    public static void CreatePasswordProtectedZip(string sourceFile, string destinationArchive, string password)
    {
        using (var zipToOpen = new FileStream(destinationArchive, FileMode.Create))
        {
            using (var archive = new ZipArchive(zipToOpen, ZipArchiveMode.Create))
            {
                var entry = archive.CreateEntryFromFile(sourceFile, Path.GetFileName(sourceFile));
                entry.Password = password;
            }
        }
    }
}

在这段代码中，我们设置 ZipArchiveEntry 的 Password 属性为 password 。任何尝试读取该压缩文件的工具或程序都将需要这个密码才能成功解压。

以上内容详细介绍了如何在C#中使用 System.IO.Compression 命名空间来压缩文件夹，包括单个文件和整个文件夹的压缩，以及一些高级技巧，如设置压缩等级和密码保护压缩文件。接下来的章节将讨论如何解压缩文件夹。

5. 解压缩文件夹的方法

在文件和数据管理中，解压缩文件夹是一个经常遇到的需求。无论是从网络上下载的压缩包，还是自己制作的备份，能够有效地将它们还原到原始状态是至关重要的。在C#中，我们有多种方法可以实现这一需求。本章将重点介绍如何使用C#进行解压缩文件夹的基本方法和一些高级技巧。

5.1 解压缩单个文件与文件夹

解压缩操作通常指的是将存储在一个压缩文件中的所有内容提取出来。这包括文件和文件夹的结构信息，确保解压缩后的文件系统状态与压缩前相同。

5.1.1 实现单个文件的解压缩

要解压缩一个文件，你需要确保该文件是一个有效的压缩包格式。以下是一个简单的示例，展示如何使用 System.IO.Compression 命名空间中的 ZipFile 类来解压缩单个文件。

using System;
using System.IO;
using System.IO.Compression;

class Program
{
    static void Main()
    {
        string zipPath = @"C:\path\to\your\archive.zip"; // 压缩文件的路径
        string extractPath = @"C:\path\to\extract\to"; // 解压缩目标路径

        ZipFile.ExtractToDirectory(zipPath, extractPath);
    }
}

上述代码段将会把 zipPath 指定的压缩文件解压缩到 extractPath 指定的目录。 ZipFile.ExtractToDirectory 方法是一个静态方法，它接受两个参数：源压缩文件路径和目标目录路径。该方法执行完毕后，压缩文件中的所有内容都会被解压到目标目录中。

5.1.2 实现整个文件夹的解压缩

当我们需要处理包含多个文件和子文件夹的大型压缩包时，上述方法同样适用。只需确保 zipPath 变量指向正确的压缩文件路径即可。

// 假设有一个压缩文件夹"C:\path\to\your\folder.zip"
string zipPath = @"C:\path\to\your\folder.zip";
string extractPath = @"C:\path\to\extract\folder";

ZipFile.ExtractToDirectory(zipPath, extractPath);

这段代码将整个压缩文件夹解压到指定目录。如果目标路径已存在同名文件，系统会抛出异常，因此在执行解压缩操作前，可能需要添加一些异常处理逻辑来覆盖或跳过这些文件。

5.2 高级解压缩技巧

除了基础的解压缩操作外，高级技巧可以帮助我们更有效地管理解压缩过程，包括检测压缩包的完整性以及解压缩到特定目录。

5.2.1 检测压缩包完整性

在解压缩文件之前验证其完整性是一个重要的步骤，可以确保文件没有损坏且在传输过程中未被篡改。以下代码展示了如何检测一个ZIP文件的完整性。

using System.IO;
using System.IO.Compression;

public class ZipIntegrityChecker
{
    public static bool VerifyZipFile(string zipPath)
    {
        try
        {
            using (var zipArchive = ZipFile.OpenRead(zipPath))
            {
                // 简单的完整性检查，确保我们可以打开ZIP文件并读取其内容。
                // 实际使用时，可能需要更复杂的校验，例如校验文件的哈希值。
            }
            return true;
        }
        catch (Exception ex)
        {
            // 在这里处理异常，例如输出错误日志
            Console.WriteLine("无法验证ZIP文件完整性: " + ex.Message);
            return false;
        }
    }
}

ZipFile.OpenRead 方法用于打开一个ZIP文件进行读取。如果文件损坏或无法打开，该方法会抛出异常，我们的 VerifyZipFile 方法会返回 false 。为了更严格的完整性校验，我们可以计算ZIP文件内各个文件的哈希值，并与预期的哈希值进行比较。

5.2.2 解压缩到特定目录

在某些情况下，你可能希望将解压缩的文件放置到一个特定的目录结构中，而不是简单地把它们放在同一个文件夹下。这可以通过修改 ZipFile.ExtractToDirectory 方法的重载版本实现，该版本允许你指定一个解压过滤器。

using System.IO;
using System.IO.Compression;

class Program
{
    static void Main()
    {
        string zipPath = @"C:\path\to\your\archive.zip";
        string extractPath = @"C:\path\to\extract\to";

        // 创建解压缩选项
        var options = new EnumerationOptions
        {
            RecurseSubdirectories = true
        };

        ZipFile.ExtractToDirectory(zipPath, extractPath, options);
    }
}

EnumerationOptions 类允许你指定一些选项，例如是否递归地解压缩子目录。通过这样的设置，你可以控制解压缩过程中的文件放置结构，以便更好地满足你的需求。

在这一章节中，我们探讨了解压缩文件的基本方法以及实现这些方法的代码示例。还介绍了一些高级技巧，包括检测压缩包的完整性和解压缩到特定目录。理解并掌握这些知识点，将有助于你在实际工作中更加高效地处理文件压缩与解压的任务。

6. 异常处理和用户进度反馈

6.1 异常处理机制

在文件压缩与解压的操作过程中，不可避免地会遇到各种异常情况，比如文件访问权限问题、磁盘空间不足、文件损坏等。一个健壮的文件处理程序需要有完善的异常处理机制来确保程序稳定运行，以及对用户友好地反馈错误信息。

6.1.1 常见异常类型及处理策略

在使用 System.IO.Compression 命名空间进行文件压缩与解压时，常见的异常类型包括但不限于以下几种：

UnauthorizedAccessException ：当程序没有足够的权限访问指定文件或文件夹时抛出。
IOException ：处理如磁盘空间不足等I/O问题时抛出。
InvalidDataException ：当压缩数据格式无效时抛出。
ArgumentOutOfRangeException ：参数值超出预期范围时抛出。

针对这些异常，我们可以采取不同的处理策略：

对于权限问题，应该提示用户检查文件或文件夹权限，并提供必要的指导。
对于I/O错误，应检查系统资源和磁盘空间，并给出相应的操作提示。
对于数据格式错误，应确保数据源的正确性，并在操作前进行数据验证。
对于参数错误，应验证输入参数的有效性，并给出清晰的错误信息。

6.1.2 异常捕获的最佳实践

在进行异常处理时，我们应该遵循以下最佳实践：

明确捕获异常类型 ：尽量避免捕获过于宽泛的异常类型，如直接捕获 Exception ，应该针对特定异常类型进行处理。
提供有用的错误信息 ：在捕获异常后，应该记录详细的错误信息并通知用户，帮助用户理解问题所在。
保持程序的健壮性 ：即使发生异常，程序也应该能够清理已经使用的资源，并保持稳定的运行状态。

例如，在压缩文件夹的过程中，我们可以使用try-catch语句块来捕获并处理可能发生的异常：

try
{
    using (ZipArchive archive = ZipFile.Open(zipFilePath, ZipArchiveMode.Update))
    {
        foreach (var file in directoryInfo.GetFiles())
        {
            archive.CreateEntryFromFile(file.FullName, file.Name);
        }
    }
}
catch (UnauthorizedAccessException ex)
{
    // 处理权限异常
    Console.WriteLine("无法访问文件，可能是因为权限问题。");
}
catch (IOException ex)
{
    // 处理I/O异常
    Console.WriteLine("发生I/O错误，可能是磁盘空间不足。");
}
catch (Exception ex)
{
    // 处理其他类型的异常
    Console.WriteLine("发生未知错误：" + ex.Message);
}

6.2 用户进度反馈

用户进度反馈对于长时间运行的操作尤其重要，它能够让用户了解到当前操作的进度，从而提升用户体验。在C#中，我们可以利用进度条来实现用户交互中的进度反馈。

6.2.1 进度条的实现方法

在文件压缩与解压的操作中，进度条可以显示压缩或解压的完成百分比。以下是一个使用控制台输出进度条的简单示例：

private static void WriteProgressBar(int percentage)
{
    Console.CursorVisible = false;
    Console.Write("[");
    int progress = percentage / 5;
    for (int i = 0; i < 20; i++)
    {
        if (i < progress)
            Console.Write("=");
        else if (i == progress)
            Console.Write(">");
        else
            Console.Write(" ");
    }
    Console.WriteLine("] " + percentage + "%");
}

然后在压缩或解压的过程中调用 WriteProgressBar 方法来显示进度：

try
{
    int percentComplete = 0;
    using (ZipArchive archive = ZipFile.Open(zipFilePath, ZipArchiveMode.Update))
    {
        foreach (var file in directoryInfo.GetFiles())
        {
            archive.CreateEntryFromFile(file.FullName, file.Name);
            percentComplete = (int)(100.0 * (double)i / directoryInfo.GetFiles().Length);
            WriteProgressBar(percentComplete);
        }
    }
}
catch (Exception ex)
{
    // 异常处理代码...
}