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

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

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

根本原因

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

解決方案

方案1：強制使用 UTF-8 編碼（推薦）

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

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:
        # 創(chuàng)建輸出目錄
        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')

關鍵建議

優(yōu)先使用 Python 3.11+：新版本對 ZIP 編碼處理更友好。
壓縮時統(tǒng)一編碼：
- 使用???????????????????????????? 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解壓文件中文亂碼內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: