Python遍历zip文件输出名称时出现乱码问题的解决方法

乱码成因与环境诊断

Windows命令行的标准输出端默认采用GBK（代号cp936）作为字符编码。当Python调用namelist()提取压缩包条目时，若文件内部存储的是其他编码的中文字符串，解释器在未做显式对齐的情况下直接将字节流转给控制台，便会触发不可逆的乱码转换。此外，直接打印整个列表对象与打印单一索引元素的差异，通常源于解释器对容器类型序列化时的隐式编码处理机制不同。

修复乱码的操作步骤

第1步：确认目标文件编码规格与控制台环境

目的：明确源数据与输出端的编码基准，避免盲目猜测。
入口：cmd窗口或集成开发环境终端。
动作：运行脚本前查看代码页，或查阅打包工具的编码设置。多数传统打包软件默认使用cp936，跨平台工具多用utf-8。
重要参数：压缩包实际存储格式与操作系统输出代码页。
完成状态：确认为后续解码步骤选定正确的源编码标识。

第2步：重写遍历逻辑并注入显式解码链

目的：绕过解释器隐式转码层，强制按已知格式还原字符串。
入口：Python源码文件顶部。
动作：在文件首行声明# -*- coding: UTF-8 -*-保障编译器解析无误。在循环内获取文件名后，先将其视为原始字节流，按cp936解码为Unicode，再直接交由打印函数处理。原文提及的二次.decode('utf-8')在现代Python中常可省略，因为解码后的字符串已是内存文本态，再次解码易引发类型错误。
重要参数：源编码标识（如'cp936'）、容错策略。
完成状态：代码片段具备明确的流向控制，不再依赖系统环境变量。

import zipfile

def listzipfilesinfo(path):
    z = zipfile.ZipFile(path, 'r')
    try:
        for filename in z.namelist():
            bytes_content = z.read(filename)
            # 核心修复：显式按cp936解码原始字节，转为标准字符串后直接输出
            # 移除多余的 .decode('utf-8') 避免二次转换报错
            display_name = filename.encode('latin1').decode('cp936', errors='replace')
            print('File:%s Size:%s' % (display_name, len(bytes_content)))
    finally:
        z.close()

# 调用示例
# listzipfilesinfo('target.zip')

第3步：运行测试并核对终端渲染状态

目的：验证编码转换链路是否完整生效。
入口：命令行窗口执行脚本。
动作：将待测ZIP路径传入函数，观察终端行列输出。
重要参数：终端字体字形库、文件路径有效性。
完成状态：屏幕连续打印出结构清晰的File:xxx Size:xxx记录，中文字符排列整齐且文件大小数值准确，无问号或方块遮挡。

关键注意事项

• 若压缩包由macOS/Linux下的zip命令生成，内部极大概率为utf-8编码，此时应将解码参数替换为filename.decode('utf-8')。
• 对于超大体积的归档文件，建议改用with zipfile.ZipFile(...) as zf:上下文管理器自动释放文件句柄，防止资源泄露。

以上就是Python遍历zip文件输出名称时出现乱码问题的详细内容，更多关于Python文件处理与编码转换的资料请关注本站其它相关文章！