Rust ZIP压缩与解压库zip32的使用：高效处理ZIP文件格式的编码与解码

zip32是Rust生态中一个高效处理ZIP文件格式的库，提供了ZIP文件的压缩和解压功能。它支持读取、创建和修改ZIP文件，是处理ZIP压缩任务的理想选择。

主要特性

• 支持读取和写入ZIP文件
• 支持压缩(Deflate算法)和存储(不压缩)两种方式
• 支持ZIP64格式(大文件支持)
• 内存友好的流式处理
• 跨平台支持

安装

在Cargo.toml中添加依赖：

[dependencies]
zip = "0.6"

基本使用方法

1. 创建ZIP文件

use std::fs::File;
use zip::write::FileOptions;
use zip::ZipWriter;

fn create_zip() -> zip::result::ZipResult<()> {
    // 创建目标ZIP文件
    let file = File::create("example.zip")?;
    let mut zip = ZipWriter::new(file);
    
    // 添加文件选项
    let options = FileOptions::default()
        .compression_method(zip::CompressionMethod::Deflated)
        .unix_permissions(0o755);
    
    // 添加一个文件
    zip.start_file("hello.txt", options)?;
    zip.write_all(b"Hello, World!")?;
    
    // 添加一个目录中的文件
    zip.add_directory("docs/", FileOptions::default())?;
    
    // 完成ZIP文件写入
    zip.finish()?;
    Ok(())
}

2. 解压ZIP文件

use std::fs::File;
use std::io;
use std::path::Path;
use zip::ZipArchive;

fn extract_zip(zip_file: &str, dest: &str) -> zip::result::ZipResult<()> {
    let file = File::open(zip_file)?;
    let mut archive = ZipArchive::new(file)?;
    
    for i in 0..archive.len() {
        let mut file = archive.by_index(i)?;
        let outpath = Path::new(dest).join(file.name());
        
        if file.name().ends_with('/') {
            // 创建目录
            std::fs::create_dir_all(&outpath)?;
        } else {
            // 创建文件
            if let Some(p) = outpath.parent() {
                if !p.exists() {
                    std::fs::create_dir_all(p)?;
                }
            }
            let mut outfile = File::create(&outpath)?;
            io::copy(&mut file, &mut outfile)?;
        }
    }
    Ok(())
}

3. 读取ZIP文件内容

use std::fs::File;
use zip::ZipArchive;

fn list_zip_contents(zip_file: &str) -> zip::result::ZipResult<()> {
    let file = File::open(zip_file)?;
    let archive = ZipArchive::new(file)?;
    
    println!("Filename\t\tSize\tCompressed\tRatio");
    for i极速 0..archive.len() {
        let file = archive.by_index(i)?;
        let ratio = (file.compressed_size() as f64 / file.size() as f64) * 100.0;
        println!("{}\t\t{}\t{}\t\t{:.2}%", 
            file.name(), 
            file.size(), 
            file.compressed_size(), 
            ratio);
    }
    Ok(())
}

高级用法

1. 处理密码保护的ZIP文件

use zip::ZipArchive;
use std::fs::File;

fn read_protected_zip(zip_file: &str, password: &str) -> zip::result::ZipResult<()> {
    let file = File::open(zip_file)?;
    let mut archive = ZipArchive::new(file)?;
    
    for i in 0..archive.len() {
        let mut file = archive.by_index_decrypt(i, password.as_bytes())??;
        let mut contents = String::new();
        file.read_to_string(&mut contents)?;
        println!("File {} contents: {}", file.name(), contents);
    }
    Ok(())
}

2. 流式处理大文件

use std::fs::File;
use std::io::{Read, Write};
use zip::write::FileOptions;
use zip::ZipWriter;

fn stream_large_file_to_zip() -> zip::result::ZipResult<()> {
    let file = File::create("large_files.zip")?;
    let mut zip = ZipWriter::new(file);
    
    let options = FileOptions::default()
        .compression_method(zip::CompressionMethod::Deflated);
    
    zip.start_file("large_data.bin", options)?;
    
    // 模拟流式写入大数据
    let chunk_size = 1024 * 1024; // 1MB chunks
    let mut buffer = vec![0; chunk_size];
    let mut source = File::open("large_source.bin")?;
    
    loop {
        let bytes_read = source.read(&mut buffer)?;
        if bytes_read == 0 {
            break;
        }
        zip.write_all(&buffer[..bytes_read])?;
    }
    
    zip.finish()?;
    Ok(())
}

完整示例

以下是一个完整的Rust程序，演示了如何使用zip32库进行ZIP文件的创建、解压和内容查看：

use std::fs::File;
use std::io::{self, Read, Write};
use std::path::Path;
use zip::{write::FileOptions, ZipArchive, ZipWriter};
use zip::result::ZipResult;

fn main() -> ZipResult<()> {
    // 1. 创建一个ZIP文件
    create_sample_zip()?;
    println!("成功创建example.zip文件");

    // 2. 列出ZIP文件内容
    println!("\nZIP文件内容:");
    list_zip_contents("example.zip")?;

    // 3. 解压ZIP文件
    extract_zip("example.zip", "extracted")?;
    println!("\n成功解压到extracted目录");

    Ok(())
}

fn create_sample_zip() -> ZipResult<()> {
    let file = File::create("example.zip")?;
    let mut zip = ZipWriter::new(file);
    
    let options = FileOptions::default()
        .compression_method(zip::CompressionMethod::Deflated);
    
    // 添加文本文件
    zip.start_file("hello.txt", options)?;
    zip.write_all(b"Hello, World!")?;
    
    // 添加二进制文件
    zip.start_file("data.bin", options)?;
    zip.write_all(&[0x01, 0x02, 0x03, 0x04])?;
    
    // 添加目录
    zip.add_directory("docs/", FileOptions::default())?;
    
    zip.finish()?;
    Ok(())
}

fn list_zip_contents(zip_file: &str) -> ZipResult<()> {
    let file = File::open(zip_file)?;
    let archive = ZipArchive::new(file)?;
    
    println!("{:<20} {:>10} {:>10} {:>8}", "文件名", "大小", "压缩后", "压缩率");
    
    for i in 0..archive.len() {
        let file = archive.by_index(i)?;
        let ratio = if file.size() > 0 {
            (file.compressed_size() as f64 / file.size() as f64) * 100.0
        } else { 
            0.0 
        };
        println!("{:<20} {:>10} {:>10} {:>7.2}%", 
            file.name(), 
            file.size(), 
            file.compressed_size(), 
            ratio);
    }
    Ok(())
}

fn extract_zip(zip_file: &str, dest: &str) -> ZipResult<()> {
    let file = File::open(zip_file)?;
    let mut archive = ZipArchive::new(file)?;
    
    for i in 0..archive.len() {
        let mut file = archive.by_index(i)?;
        let outpath = Path::new(dest).join(file.name());
        
        if file.name().ends_with('/') {
            std::fs::create_dir_all(&outpath)?;
        } else {
            if let Some(p) = outpath.parent() {
                if !p.exists() {
                    std::fs::create_dir_all(p)?;
                }
            }
            let mut outfile = File::create(&outpath)?;
            io::copy(&mut file, &mut outfile)?;
        }
    }
    Ok(())
}

注意事项

1. 处理用户提供的ZIP文件时要注意安全性，防止ZIP炸弹攻击
2. 对于非常大的文件(>4GB)，确保启用ZIP64支持
3. 跨平台使用时注意文件路径的兼容性问题
4. 密码保护功能使用传统的ZIP加密，安全性有限

zip32库提供了强大而灵活的ZIP文件处理能力，适合各种压缩解压场景。通过合理使用其API，可以高效地处理ZIP文件操作。