8 码分享团队手记

付费 ZIP 的中文文件名变成乱码?上传前这样验一遍

如果买家解压后能打开文件,但「使用说明.txt」显示成一串符号,先看 ZIP 里的文件名编码。下面用两份含相同文件的 ZIP 演示怎么判断,以及修好后如何用个人微信或支付宝做成付费下载链接。

本文由高维实验室(8 码分享团队)整理,使用 AI 辅助写作。实验用虚构样例,在 Linux 上用 Python 3.13.13 实测。

两个 ZIP,解压结果有什么差别

我们把同一份「使用说明.txt」和「示例订单.csv」分别写进两个包。第一份给中文文件名写了 UTF-8 标记。第二份模拟只写入 GBK 文件名、未标记编码的旧 ZIP。

解压方式 文件名 文件内容
UTF-8 ZIP,Python 默认解压 两个中文名正常 与源文件一致
模拟旧 ZIP,Python 默认解压 两个中文名均乱码 与源文件一致
同一个旧 ZIP,明确按 GBK 解压 两个中文名恢复 与源文件一致

表里的 GBK 是已知的实验条件。手上的旧包如果来源不明,先和制作者核对原始文件名,或请对方用原文件重新打包。Python 的 ZIP 文件名编码说明

用 Python 复现这三种读取结果

把这段存成 check_zip.py,用 Python 3.11 或更新版本运行 python check_zip.py。脚本自己创建临时 ZIP,只读取包内名字和内容,不向当前目录解压。这里用 ZipInfo 的私有方法造一份旧格式样本,日常打包直接用普通的 writestr 即可。

from pathlib import Path
from tempfile import TemporaryDirectory
from zipfile import ZipFile, ZipInfo


class GBKFileName(ZipInfo):
    # 只为模拟旧工具的写法。实际制作 ZIP 时用普通的 writestr。
    def _encodeFilenameFlags(self):
        return self.filename.encode("gbk"), 0


name = "使用说明.txt"
data = b"demo"
with TemporaryDirectory() as folder:
    root = Path(folder)
    inputs = [(root / "utf8.zip", name), (root / "old.zip", GBKFileName(name))]
    for path, member in inputs:
        with ZipFile(path, "w") as archive:
            archive.writestr(member, data)

    results = []
    for path, encoding in [(inputs[0][0], None), (inputs[1][0], None), (inputs[1][0], "gbk")]:
        with ZipFile(path, metadata_encoding=encoding) as archive:
            member, = archive.infolist()
            assert archive.read(member) == data
            results.append(member.filename)
            print(path.name, encoding or "default", member.filename)

    assert results[0] == results[2] == name
    assert results[1] != name

在 Python 3.13.13 的实测里,第一行与第三行都打印「使用说明.txt」,中间一行因没按 GBK 读取而显示乱码。三次都读回了同样的文件内容。metadata_encoding 只处理未标记 UTF-8 的旧名字。遇到来源不明的 ZIP,可以先对照发件人提供的文件清单再选编码。

打包后填一遍文件清单

  1. 手上有原文件时,用支持 UTF-8 文件名的工具新建 ZIP。也可以把教学文件统一命名为 readme.txt 和 example-orders.csv,在说明里写出各自的用途。
  2. 把最终的 ZIP 解压到一个空目录。对照商品说明核对文件名、数量与目录层级,再实际打开说明和样例。表格包可以改一笔虚构订单,确认合计会重新计算。
  3. 如果你承诺给 Windows 或 macOS 用户使用,找一台对应系统的设备,用买家常用的解压工具验一遍。本文的结果来自上表所列的 Linux 环境。

商品说明示例
ZIP 内含空白模板、示例订单和使用说明。请先完整解压,再打开使用说明。如果文件名变成乱码,请保留原 ZIP,并注明解压软件和系统版本,以便定位。

如果中文文件名显示正常,再检查同一目录里有没有只差大小写的名字,例如 README.txt 和 readme.txt。遇到这种情况,把两个文件改成能看出用途的名字后重新打包。见实测:两份 ZIP 的文件名冲突对照。

把验过的 ZIP 做成付费链接

  1. 进 8 码分享工作台的「收款通道」。选微信时,在 Windows 运行微信收款助手,从网页获取激活码并完成激活,确认通道在线。选支付宝时,用本人支付宝扫码激活,上传收款码并保存。本人已有适用于当前经营场景的个人经营收款码时,建议优先使用。
  2. 发布「文件」资源,上传验过的 ZIP,写清价格、文件清单与适用软件,再复制分享链接。个人收款服务费从预充值的平台额度扣除,新用户有 20 元体验额度。
  3. 用手机打开购买页核对金额和能用的付款方式。买家按该笔订单页面显示的金额付款,订单确认付款后才能领取 ZIP。查看微信与支付宝通道的设置步骤 · 查看买家付款与查单步骤