Python 实用技：解压 ZIP 文件的三种姿势（从一行命令到进阶脚本）

在日常开发，尤其是 AI 模型部署（如 YOLO、LLM 权重部署）中，我们经常需要在 Linux 服务器或 Docker 容器中处理压缩包。有时候容器里甚至没有安装unzip命令，这时候 Python 就成了我们的救命稻草。

本文总结了使用 Python 解压 ZIP 文件的三种常用方法，涵盖了从最简单的命令行操作到处理中文乱码的进阶技巧。

方法一：命令行“一行流” (最快、无需写脚本)

这是最简单、最快的方法。Python 标准库自带zipfile模块，可以直接在终端调用，无需编写任何.py文件。非常适合在Docker 容器或临时环境中使用。

语法：

python -m zipfile -e<压缩包名><解压目标目录>

示例：
将model_weights.zip解压到当前目录（.）：

python -m zipfile -e model_weights.zip.

原理：-m参数将库模块当作脚本运行，-e代表 extract（解压）。

方法二：标准库zipfile(基础脚本)

如果你需要在 Python 代码中集成解压功能，zipfile是最标准的选择。建议使用with语句（上下文管理器），这样可以确保文件在使用后自动关闭，即使发生错误也不会占用文件句柄。

importzipfileimportosdefunzip_file(zip_src,dst_dir):# 如果目标目录不存在，则创建ifnotos.path.exists(dst_dir):os.makedirs(dst_dir)print(f"开始解压:{zip_src}...")try:withzipfile.ZipFile(zip_src,'r')aszfile:# extractall 会解压所有文件zfile.extractall(path=dst_dir)print(f"✅ 解压完成，文件已保存至:{dst_dir}")exceptzipfile.BadZipFile:print("❌ 错误: 文件已损坏或不是有效的 ZIP 文件")exceptExceptionase:print(f"❌ 发生未知错误:{e}")# 调用示例if__name__=="__main__":unzip_file("merged_qwen3vl_model.zip","./model_output")

方法三：进阶操作 (大文件进度条 + 中文乱码修复)

作为 AI 开发者，我们解压的模型往往高达几 GB 甚至几十 GB。如果没有进度条，对着黑屏傻等是非常焦虑的。此外，Windows 下打包的中文文件名在 Linux 下解压常会出现乱码。

下面的脚本解决了这两个痛点：

1. 依赖安装

我们需要tqdm来显示进度条（做 AI 的同学应该都有这个库）：

pipinstalltqdm

2. 完整代码

importzipfileimportosfromtqdmimporttqdmdefunzip_with_progress(zip_src,dst_dir):ifnotos.path.exists(dst_dir):os.makedirs(dst_dir)withzipfile.ZipFile(zip_src,'r')aszfile:# 获取所有文件列表members=zfile.infolist()# 初始化进度条，total 是文件总大小total_size=sum(file.file_sizeforfileinmembers)print(f"正在解压{zip_src}到{dst_dir}...")withtqdm(total=total_size,unit='B',unit_scale=True,unit_divisor=1024)aspbar:formemberinmembers:# --- 中文乱码修复核心代码 (可选) ---# Windows 压缩包通常用 CP437 编码文件名，Linux 需要转回 GBK 或 UTF-8try:member.filename=member.filename.encode('cp437').decode('gbk')except:# 如果转换失败，保持原样（说明可能是 UTF-8）pass# --------------------------------# 解压单个文件zfile.extract(member,dst_dir)# 更新进度条pbar.update(member.file_size)if__name__=="__main__":# 示例：解压一个大模型权重unzip_with_progress("large_model_weights.zip","./models")

总结

希望这篇笔记能帮你解决 Linux 环境下的解压难题！如果觉得有用，欢迎点赞收藏。