Python解壓zip文件名亂碼問題的具體分析和解決方案

更新時間：2025年09月18日 10:12:02 作者：detayun

使用Python處理含有中文文件名的壓縮文件時,這些中文文件名會出現(xiàn)亂碼,今天我們就來看一下如何來解決這個亂碼的問題,以下是具體分析和解決方案,需要的朋友可以參考下

問題根源分析

ZIP格式：

傳統(tǒng)ZIP文件（尤其Windows生成）默認使用CP437編碼（IBM PC字符集），而非UTF-8。
Python的zipfile模塊默認按CP437解碼，導(dǎo)致中文亂碼。

TAR格式：

舊版tar工具可能使用系統(tǒng)默認編碼（如Windows的GBK，Linux的UTF-8）。
Python的tarfile模塊默認按當(dāng)前系統(tǒng)編碼解析，跨平臺時易出錯。

GZ/BZ2格式：

通常只壓縮單個文件，文件名由用戶指定，較少直接涉及編碼問題。

修復(fù)方案

修改解壓函數(shù)，顯式指定編碼格式：

import zipfile
import tarfile
import gzip
import bz2
import os
import shutil

def extract_archive(archive_path, extract_to='.', encoding='utf-8'):
    """支持中文路徑的解壓函數(shù)"""
    comp_type = detect_compression(archive_path)

    # 根據(jù)類型調(diào)用對應(yīng)解壓方法
    if comp_type == 'zip':
        # 關(guān)鍵修復(fù)：強制使用指定編碼
        with zipfile.ZipFile(archive_path, 'r') as zip_ref:
            # 處理亂碼：將亂碼文件名轉(zhuǎn)換為正確編碼
            for file in zip_ref.namelist():
                try:
                    # 嘗試用指定編碼解析文件名
                    fixed_name = file.encode('cp437').decode(encoding)
                except:
                    fixed_name = file
                # 重命名文件
                zip_ref.NameToInfo[file].filename = fixed_name
            zip_ref.extractall(extract_to)
            
    elif comp_type == 'tar':
        # 關(guān)鍵修復(fù)：指定編碼打開tar
        with tarfile.open(archive_path, 'r', encoding=encoding) as tar_ref:
            tar_ref.extractall(extract_to)
            
    elif comp_type == 'gz':
        # 注意：gz通常只壓縮單個文件，文件名需手動處理
        raw_name = os.path.basename(archive_path)[:-3]
        output_path = os.path.join(extract_to, raw_name)
        with gzip.open(archive_path, 'rb') as gz_ref:
            with open(output_path, 'wb') as out_file:
                shutil.copyfileobj(gz_ref, out_file)
                
    elif comp_type == 'bz2':
        raw_name = os.path.basename(archive_path)[:-4]
        output_path = os.path.join(extract_to, raw_name)
        with bz2.open(archive_path, 'rb') as bz2_ref:
            with open(output_path, 'wb') as out_file:
                shutil.copyfileobj(bz2_ref, out_file)
    else:
        print(f"不支持的壓縮格式: {archive_path}")