首页 > 脚本专栏 > python > Python zipfile解压文件中文乱码

Python使用zipfile解压文件中文乱码问题的具体原因和解决方案

2025-09-22 08:39:47 作者：detayun

在 Python 中使用 zipfile 模块解压文件时,中文文件名乱码通常是由于 ZIP 文件的编码标准不统一导致的,本文给大家介绍了详细的原因和解决方案,需要的朋友可以参考下

在 Python 中使用 zipfile 模块解压文件时，中文文件名乱码通常是由于 ZIP 文件的编码标准不统一 导致的。以下是具体原因和解决方案：

根本原因

ZIP 标准的历史问题：ZIP 格式最初设计时未明确规定文件名编码，不同压缩工具可能使用 CP437（IBM PC 字符集）、GBK（简体中文）、UTF-8 等编码存储文件名。
Python 的默认行为：zipfile 模块默认使用 CP437 解码文件名，若 ZIP 文件中实际使用其他编码（如 GBK 或 UTF-8），则会出现乱码。

解决方案

方案1：强制使用 UTF-8 编码（推荐）

在 Python 3.11+ 中，可通过 zipfile.ZipFile 的 metadata_encoding 参数显式指定编码：

import zipfile

# 强制使用 UTF-8 编码解析文件名
with zipfile.ZipFile('archive.zip', 'r', metadata_encoding='utf-8') as zip_ref:
    zip_ref.extractall('./output_folder')

方案2：兼容多种编码的通用方法

若不确定 ZIP 文件的编码，可尝试自动检测并修复乱码文件名：

import os
import zipfile

def fix_zipfile_encoding(zip_path, output_dir):
    with zipfile.ZipFile(zip_path, 'r') as zip_ref:
        # 创建输出目录
        os.makedirs(output_dir, exist_ok=True)
        
        # 遍历 ZIP 文件中的每个条目
        for info in zip_ref.infolist():
            try:
                # 尝试用 UTF-8 解码
                original_name = info.filename
                decoded_name = original_name.encode('cp437').decode('utf-8')
            except UnicodeDecodeError:
                # 若失败，尝试用 GBK 解码
                decoded_name = original_name.encode('cp437').decode('gbk')
            
            # 构造完整路径
            target_path = os.path.join(output_dir, decoded_name)
            
            # 确保目标目录存在
            os.makedirs(os.path.dirname(target_path), exist_ok=True)
            
            # 解压文件
            with zip_ref.open(info) as source, open(target_path, 'wb') as target:
                target.write(source.read())

# 使用示例
fix_zipfile_encoding('archive.zip', './fixed_output')

方案3：使用第三方工具（如 py7zr）

py7zr 库支持更好的编码处理：

pip install py7zr

import py7zr

with py7zr.SevenZipFile('archive.zip', 'r') as z:
    z.extractall(path='./output_folder')

关键建议

优先使用 Python 3.11+：新版本对 ZIP 编码处理更友好。
压缩时统一编码：
- 使用 zipfile 压缩时显式指定编码：

with zipfile.ZipFile('archive.zip', 'w', metadata_encoding='utf-8') as zipf:
    zipf.write('文档.txt', arcname='文档.txt')

推荐使用 7-Zip 或 WinRAR 等工具压缩时选择 UTF-8 编码。

避免跨平台问题：Windows 默认使用 GBK 编码，Linux/macOS 多用 UTF-8，跨平台传输 ZIP 文件时需注意编码一致。

验证方法

解压后检查文件名是否正常：

# 检查输出目录中的文件
import os
output_dir = './fixed_output'
files = [f for f in os.listdir(output_dir) if os.path.isfile(os.path.join(output_dir, f))]
print("解压后的文件:", files)  # 应显示正确的中文名

通过上述方法，可有效解决 ZIP 文件解压时的中文乱码问题。如遇特殊压缩工具（如某些旧版 WinRAR），可能需要手动调整解码策略。

到此这篇关于Python使用zipfile解压文件中文乱码问题的具体原因和解决方案的文章就介绍到这了,更多相关Python zipfile解压文件中文乱码内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！