Python解压ZIP中文文件名乱码的终极解决方案(自动识别编码+嵌套解压通用脚本)

# -*- coding: utf-8 -*-
"""
Python ZIP压缩包万能解压脚本
功能：自动识别GBK/UTF-8编码、修复中文文件名乱码、支持嵌套ZIP压缩包递归解压
适配：全Python版本、Windows/麒麟Linux/macOS全平台
"""
import zipfile
import os

def unzip_file_auto_encoding(zip_path: str, output_root: str) -> None:
    """
    通用解压函数，自动识别编码、处理中文乱码、递归解压嵌套zip
    :param zip_path: 待解压的zip文件绝对/相对路径
    :param output_root: 文件解压输出根目录
    """
    # 确保输出根目录存在，不存在则自动创建
    os.makedirs(output_root, exist_ok=True)

    # 打开ZIP压缩包
    with zipfile.ZipFile(zip_path, "r") as zf:
        # 遍历压缩包内所有文件/目录名
        for file_name in zf.namelist():
            real_file_name = ""
            # 自动编码识别：优先GBK（Windows压缩包），失败则尝试UTF-8（Linux/macOS/麒麟系统）
            try:
                # 核心修复逻辑：先还原CP437原始编码，再解码为中文GBK
                real_file_name = file_name.encode("cp437").decode("gbk")
            except UnicodeDecodeError:
                # GBK解码失败，切换UTF-8解码
                real_file_name = file_name.encode("cp437").decode("utf-8")

            # 拼接解压后的完整文件路径
            full_file_path = os.path.join(output_root, real_file_name)

            # 处理目录：自动创建嵌套文件夹
            if file_name.endswith("/"):
                os.makedirs(full_file_path, exist_ok=True)
            # 处理普通文件
            else:
                # 先解压原始乱码文件，再重命名为正确中文名称
                zf.extract(file_name, output_root)
                os.rename(os.path.join(output_root, file_name), full_file_path)

            # 递归处理：如果解压出嵌套ZIP压缩包，自动二次解压
            if real_file_name.lower().endswith(".zip"):
                # 嵌套压缩包解压到同名子目录，避免文件混淆
                nest_output_dir = os.path.join(output_root, real_file_name[:-4])
                unzip_file_auto_encoding(full_file_path, nest_output_dir)
                # 可选：解压完成后删除原嵌套压缩包，按需开启
                # os.remove(full_file_path)

# ====================== 脚本使用入口 ======================
if __name__ == "__main__":
    # 配置参数：按需修改以下路径即可
    TARGET_ZIP = "test.zip"    # 待解压的压缩包路径
    OUTPUT_DIR = "unzip_out"   # 解压文件输出目录

    # 执行解压
    unzip_file_auto_encoding(TARGET_ZIP, OUTPUT_DIR)
    print(f"✅ 解压完成！所有文件已输出至：{os.path.abspath(OUTPUT_DIR)}")

# -*- coding: utf-8 -*-
import zipfile

# 适配Windows GBK编码压缩包
with zipfile.ZipFile("test.zip", "r", metadata_encoding="gbk") as zf:
    zf.extractall("unzip_out")

# 适配Linux/macOS/麒麟UTF-8编码压缩包
# with zipfile.ZipFile("test.zip", "r", metadata_encoding="utf-8") as zf:
#     zf.extractall("unzip_out")

pip install patool

import patoolib
# 自动适配编码、一键解压所有压缩包
patoolib.extract_archive("test.zip", outdir="unzip_out")