Python标准库zipfile和tarfile分别处理ZIP与TAR(含gzip/bzip2/xz)归档,支持创建、解压、内容查看及安全校验;zipfile需手动遍历添加文件并设置压缩参数,tarfile的add()自动递归目录但需防范路径遍历风险。

Python 提供了 zipfile 和 tarfile 两个标准库,分别用于处理 ZIP 和 TAR(含 gzip/bzip2/xz 压缩)格式的归档文件。它们无需额外安装,开箱即用,适合自动化打包、解包、检查内容等常见任务。
用 zipfile 创建和解压 ZIP 文件
zipfile 支持读写 ZIP 文件,能添加单个文件、整个目录,也可遍历查看内容。
- 创建 ZIP:用
ZipFile(..., 'w')打开,再调用write()添加文件;注意路径默认保留相对结构,可用arcname自定义归档内路径 - 解压 ZIP:用
extractall()一键解到指定目录;若只解部分文件,可用extract()或extractall(members=[...]) - 查看内容:
namelist()返回所有文件名列表,infolist()返回含大小、修改时间等信息的ZipInfo对象 - 注意:写入时默认不压缩,如需压缩需传入
compression=zipfile.ZIP_DEFLATED,并确保 zlib 可用
用 tarfile 处理 TAR 及压缩 TAR 包
tarfile 支持多种格式:'r'(普通 TAR)、'r:gz'(gzip)、'r:bz2'(bzip2)、'r:xz'(xz),写入同理。
- 创建 TAR 包:用
TarFile(..., 'w:gz')打开,再用add()添加文件或目录;add()默认递归包含子目录,可设recursive=False控制 - 解压 TAR:调用
extractall(),支持指定path解压位置;同样可用members参数筛选要解的条目 - 安全提醒:直接调用
extractall()存在路径遍历风险(如文件名为../../etc/passwd),生产环境建议先校验tarinfo.name是否为安全路径(例如用os.path.isabs()和os.path.normpath()检查) - 读取内容:用
getnames()获取文件名列表,getmembers()获取详细TarInfo对象
跨格式统一操作的小技巧
虽然 ZIP 和 TAR 接口不同,但常见需求可以抽象出相似逻辑:
Orz企业网站管理系统整合了企业网站所需要的大部分功能,并在其基础上做了双语美化。压缩包内有必须的图片psd源文件,方便大家修改。 Orz企业网站管理系统功能: 1.动态首页 2.中英文双语同后台管理 3.产品具有询价功能 4.留言板功能 5.动态营销网络 6.打印功能 7.双击自动滚动 Orz企业网站管理系统安装 1、请将官方程序包解压后上传至您的虚拟主机即可正常使用; 2、后台管理面板登录:
立即学习“Python免费学习笔记(深入)”;
- 批量加文件:ZIP 用循环
write();TAR 用add()更方便(自动处理目录) - 避免硬编码路径:统一使用
os.path.relpath()或pathlib.Path构造相对路径,保证归档结构清晰 - 错误处理:打开文件前建议先
os.path.exists()判断源是否存在;解压时捕获tarfile.TarError或zipfile.BadZipFile等异常 - 内存友好:大文件场景下,ZIP 不支持流式写入,TAR 的
addfile()+ 手动构造TarInfo可实现边生成边写入,但较复杂,一般推荐分块处理
简单实用示例:一键打包当前目录为 zip 并带时间戳
以下代码生成形如 backup_20241115.zip 的压缩包,排除 __pycache__ 和 .git 目录:
import zipfile
import os
from datetime import datetime
def backup_to_zip(folder):
date = datetime.now().strftime('%Y%m%d')
zip_name = f'backup_{date}.zip'
with zipfile.ZipFile(zip_name, 'w', zipfile.ZIP_DEFLATED) as zf:
for root, dirs, files in os.walk(folder):
# 过滤掉不需要的目录
dirs[:] = [d for d in dirs if d not in ('__pycache__', '.git')]
for file in files:
file_path = os.path.join(root, file)
arcname = os.path.relpath(file_path, folder)
zf.write(file_path, arcname)
return zip_name
backup_to_zip('.')









