在Python中处理ZIP文件时，zipfile模块是最常用的工具。它提供了创建、读取、修改ZIP文件的完整功能，无需依赖外部命令。本文将通过核心函数、实战案例和避坑指南，带你掌握这个高效的文件处理模块！

一、ZipFile 类详解：核心参数与方法

1.构造函数：ZipFile (file, mode='r', compression=ZIP_STORED, allowZip64=True)

关键参数：

2.核心方法：文件操作

添加文件

• 添加文件：write(filename, arcname=None, compress_type=None)
  将本地文件添加到ZIP，arcname指定ZIP内的路径,注意路径中使用‘/’，不使用‘\’

import zipfile

# 使用最高压缩级别创建ZIP
with zipfile.ZipFile('compressed.zip', 'w', compression=zipfile.ZIP_DEFLATED) as zipf:
    zipf.write('log.txt')  # 自动压缩文件
    zipf.write('forder/', arcname='new_folder/')  # 仅添加目录名

问题：若filename是文件，则添加该文件；若filename是目录，则仅添加目录名（空目录），不会递归添加其内容。

• 直接写入字符串或字节数据：writestr(zinfo_or_arcname, data, compress_type=None)

import zipfile

with zipfile.ZipFile('inline.zip', 'w') as zipf:
    zipf.writestr('1.txt', 'This is a test file.')  # 添加文件并写入文本
    zipf.writestr('2.txt', b'\xff\xd8\xff\xe0...')  # 添加文件并写入二进制

设置解压密码：setpassword(pwd) 密码为bytes 类型，否则报错

with zipfile.ZipFile('secure.zip', 'w') as zipf:
    zipf.setpassword(b'123456')  # 设置密码
    zipf.write('confidential.txt')

但是标准库zipfile设置加密密码后，其实不会生效，无需密码也可以解压文件。后面我们再介绍其他的一些加密方法。

解压单个文件：extract(member, path=None, pwd=None)
参数：

• member：ZIP 内的文件名或ZipInfo对象。
• path：解压目标路径（默认当前目录）。
• pwd：解压密码（默认为None）

案例：解压指定文件

with zipfile.ZipFile('example.zip', 'r') as zipf:
    zipf.extract('data.txt', 'extract_dir/')  # 解压到指定目录

解压所有文件：extractall(path=None, members=None, pwd=None)
参数：

• path：指定解压的目录（默认当前目录）。
• members：指定解压的文件列表（默认全部）。
• pwd：解压密码（默认为None）

#案例：解压全部内容到某个目录
with zipfile.ZipFile('example.zip', 'r') as zipf:
    zipf.extractall('extracted_files/')

案例：解压部分内容
with zipfile.ZipFile('example.zip', 'r') as zipf:
    zipf.extractall(members=['1.txt','xxxxdir/'])

打开ZIP内的文件对象（不提取到磁盘）：open(name, mode='r', pwd=None)
参数：

• name：指定打开的文件名
• mode：跟open函数类似的mode，r表示读取，w表示写入，a表示追加等
• pwd：解压密码（默认为None）

with zipfile.ZipFile('data.zip') as zipf:
    with zipf.open('config.json') as f:
        content = f.read().decode('utf-8')  # 读取文本内容

直接读取ZIP内的某个文件内容：read(name, pwd=None)参数：

• name：指定打开的文件名
• pwd：解压密码（默认为None）

with zipfile.ZipFile('data.zip') as zipf:
    content = zipf.read('config.json')

校验ZIP文件完整性：testzip() 返回第一个损坏的文件名（无损坏返回None）：

with zipfile.ZipFile('downloaded.zip') as zipf:
    if zipf.testzip() is None:
        print("文件完整")
    else:
        print(f"文件损坏: {zipf.testzip()}")

文件信息查询

• namelist() 返回 ZIP 内所有文件的名称列表：

with zipfile.ZipFile('project.zip') as zipf:
    print(zipf.namelist())  # 输出一个列表

• getinfo(name) 返回ZipInfo对象，包含文件详细信息：

with zipfile.ZipFile('archive.zip') as zipf:
    info = zipf.getinfo('data.csv')
    print(f"文件大小: {info.file_size} 字节")
    print(f"压缩后: {info.compress_size} 字节")
    print(f"压缩比: {info.compress_size/info.file_size:.2%}")
    print(f"修改时间: {info.date_time}")  # (年, 月, 日, 时, 分, 秒)

#输出类似：
文件大小: 20 字节
压缩后: 20 字节
压缩比: 100.00%
修改时间: (2025, 6, 5, 21, 57, 52)

• infolist() 返回所有文件的ZipInfo列表

with zipfile.ZipFile('package.zip') as zipf:
    for info in zipf.infolist():
        print(f"{info.filename}: {info.file_size} bytes")
#输出类似：
new_folder/: 0 bytes
report.txt: 20 bytes
image.jpg: 7 bytes

三、进阶操作

1.压缩目录

• 问题：直接添加目录不会保存其结构，需递归处理。配合os.walk函数实现递归压缩目录内容

import os
import zipfile

def zip_directory(directory, zip_file):
    with zipfile.ZipFile(zip_file, 'w', zipfile.ZIP_DEFLATED) as zipf:
        for root, dirs, files in os.walk(directory):
            print(root)
            print(dirs)
            print(files)
            for file in files:
                file_path = os.path.join(root, file)
                print(file_path)
                zipf.write(file_path)

# 使用示例
zip_directory('compressed', '1.zip')

2.选择性解压（基于文件大小）

with zipfile.ZipFile('dataset.zip') as zipf:
    for info in zipf.infolist():
        if info.file_size < 1024 * 1024:  # 小于1MB的文件
            zipf.extract(info, 'small_files/')

3.创建内存 ZIP（不落地磁盘）

import io
import zipfile

# 创建内存ZIP
buffer = io.BytesIO()
with zipfile.ZipFile(buffer, 'w') as zipf:
    zipf.writestr('report.txt', 'Monthly sales report...')
    zipf.write('data.csv')  # 添加本地文件

# 将内存ZIP发送到网络或保存
with open('memory_zip.zip', 'wb') as f:
    f.write(buffer.getvalue())

4.修改ZIP内文件（不重建整个ZIP）

import zipfile
import os

def replace_file_in_zip(zip_path, old_file, new_content):
    # 创建临时ZIP
    temp_path = zip_path + '.temp'
    with zipfile.ZipFile(zip_path, 'r') as old_zip, \
         zipfile.ZipFile(temp_path, 'w') as new_zip:
        
        # 复制所有文件，替换指定文件
        for item in old_zip.infolist():
            if item.filename == old_file:
                new_zip.writestr(item, new_content)  # 替换内容
            else:
                new_zip.writestr(item, old_zip.read(item))
    
    # 替换原ZIP
    os.replace(temp_path, zip_path)

# 使用示例
replace_file_in_zip('config.zip', 'settings.ini', 'NEW_CONFIG_DATA')

五、ZipFile函数速查表

六 总结

python自带的zipfile模块可以满足最基本的压缩功能，但也少了一些比如添加压缩密码，压缩目录的功能，如果想使用这些，我们后面再结合其他模块介绍。

----感谢读者的阅读，明天的你定会感谢今天的自己！！！！----