zipfile 是 Python 標準庫中處理 ZIP 歸檔文件的核心模塊,支持讀取、創建、解壓、加密等操作,適用於文件打包分發、備份、數據傳輸等場景。
zipfile.ZipFile(file, mode='r', compression=ZIP_STORED, allowZip64=True)
file:文件路徑或類文件對象。mode:'r' 讀取、'w' 新建/覆蓋、'a' 追加。compression:ZIP_STORED (無壓縮) 或 ZIP_DEFLATED (需 zlib)。allowZip64:處理 >2GB 文件時必須為 True。| 方法 | 說明 |
|---|---|
getinfo(name) | 獲取指定文件的 ZipInfo 對象 |
infolist() | 返回所有文件的 ZipInfo 列表 |
namelist() | 返回所有文件名列表 |
extract(member, path, pwd) | 解壓單個文件到指定目錄 |
extractall(path, members, pwd) | 批量解壓,可指定文件子集 |
printdir() | 打印歸檔目錄信息到控制台 |
setpassword(pwd) | 設置解壓密碼(bytes 類型) |
read(name, pwd) | 直接讀取文件二進制內容,無需解壓到磁盤 |
write(filename, arcname, compress_type) | 添加文件到歸檔 |
writestr(zinfo_or_arcname, bytes) | 將二進制數據直接寫入歸檔 |
import zipfile, os
zip_path = os.path.join(os.getcwd(), 'txt.zip')
with zipfile.ZipFile(zip_path) as zf:
zf.extractall(r'd:/Work')
with zipfile.ZipFile(r'D:/test.zip', 'w', zipfile.ZIP_DEFLATED) as zf:
zf.write(r'D:/test.doc', 'ok.doc') # 存儲名為 ok.doc
with zipfile.ZipFile(zip_path) as zf:
data = zf.read('txt.txt')
with open(r'd:/txt.txt', 'wb') as f:
f.write(data)
with zipfile.ZipFile(zip_path) as zf:
for info in zf.infolist():
print(f"{info.filename:30} {info.file_size:>10} bytes "
f"壓縮後: {info.compress_size:>10} "
f"CRC32: {info.CRC:08X} "
f"修改時間: {info.date_time}")
ZipInfo 對象包含文件的完整元數據:
filename、date_time (6 元組)、compress_typefile_size (原始大小)、compress_size (壓縮後大小)CRC (CRC-32 校驗值)external_attr (外部屬性,高 16 位存 Unix 權限)create_system (0=Windows, 3=Unix)with 語句) 自動關閉文件,防止資源洩漏。allowZip64=True,考慮分卷或流式處理。ZipInfo.flag_bits。ZipFile 對象,避免重複打開關閉。zipfile 功能豐富且無第三方依賴,是 Python 處理 ZIP 文件的首選工具。掌握其核心 API 與 ZipInfo 元數據訪問,即可應對絕大多數歸檔場景。