快捷導(dǎo)航

Python使用zipfile解壓文件中文亂碼問(wèn)題的具體原因和解決方案

更新時(shí)間：2025年09月22日 08:39:47 作者：detayun

在 Python 中使用 zipfile 模塊解壓文件時(shí),中文文件名亂碼通常是由于 ZIP 文件的編碼標(biāo)準(zhǔn)不統(tǒng)一導(dǎo)致的,本文給大家介紹了詳細(xì)的原因和解決方案,需要的朋友可以參考下

根本原因

ZIP 標(biāo)準(zhǔn)的歷史問(wèn)題：ZIP 格式最初設(shè)計(jì)時(shí)未明確規(guī)定文件名編碼，不同壓縮工具可能使用 CP437（IBM PC 字符集）、GBK（簡(jiǎn)體中文）、UTF-8 等編碼存儲(chǔ)文件名。
Python 的默認(rèn)行為：zipfile 模塊默認(rèn)使用 CP437 解碼文件名，若 ZIP 文件中實(shí)際使用其他編碼（如 GBK 或 UTF-8），則會(huì)出現(xiàn)亂碼。

解決方案

方案1：強(qiáng)制使用 UTF-8 編碼（推薦）

在 Python 3.11+ 中，可通過(guò) zipfile.ZipFile 的 metadata_encoding 參數(shù)顯式指定編碼：

import zipfile

# 強(qiáng)制使用 UTF-8 編碼解析文件名
with zipfile.ZipFile('archive.zip', 'r', metadata_encoding='utf-8') as zip_ref:
    zip_ref.extractall('./output_folder')

方案2：兼容多種編碼的通用方法

若不確定 ZIP 文件的編碼，可嘗試自動(dòng)檢測(cè)并修復(fù)亂碼文件名：

import os
import zipfile

def fix_zipfile_encoding(zip_path, output_dir):
    with zipfile.ZipFile(zip_path, 'r') as zip_ref:
        # 創(chuàng)建輸出目錄
        os.makedirs(output_dir, exist_ok=True)
        
        # 遍歷 ZIP 文件中的每個(gè)條目
        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')
            
            # 構(gòu)造完整路徑
            target_path = os.path.join(output_dir, decoded_name)
            
            # 確保目標(biāo)目錄存在
            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 庫(kù)支持更好的編碼處理：

pip install py7zr

import py7zr

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

關(guān)鍵建議

優(yōu)先使用 Python 3.11+：新版本對(duì) ZIP 編碼處理更友好。
壓縮時(shí)統(tǒng)一編碼：
- 使用???????????????????????????? zipfile 壓縮時(shí)顯式指定編碼：

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

推薦使用 7-Zip 或 WinRAR 等工具壓縮時(shí)選擇 UTF-8 編碼。

避免跨平臺(tái)問(wèn)題：Windows 默認(rèn)使用 GBK 編碼，Linux/macOS 多用 UTF-8，跨平臺(tái)傳輸 ZIP 文件時(shí)需注意編碼一致。

驗(yàn)證方法

解壓后檢查文件名是否正常：

# 檢查輸出目錄中的文件
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)  # 應(yīng)顯示正確的中文名

通過(guò)上述方法，可有效解決 ZIP 文件解壓時(shí)的中文亂碼問(wèn)題。如遇特殊壓縮工具（如某些舊版 WinRAR），可能需要手動(dòng)調(diào)整解碼策略。

到此這篇關(guān)于Python使用zipfile解壓文件中文亂碼問(wèn)題的具體原因和解決方案的文章就介紹到這了,更多相關(guān)Python zipfile解壓文件中文亂碼內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: