如何修复 Python 中 zipfile.ZipFile() 无法执行的问题

浅晨大大_7966

浅晨大大_7966

2026-11-20

204人浏览

原创

如何修复 Python 中 zipfile.ZipFile() 无法执行的问题

本文详解因 if __name__ == "__ main __": 中多余空格导致 ZIP 打包函数失效的根本原因及正确写法,附完整可运行示例与关键注意事项。

本文详解因 `if __name__ == "__ main __":` 中多余空格导致 zip 打包函数失效的根本原因及正确写法,附完整可运行示例与关键注意事项。

在使用 Python 的 zipfile.ZipFile() 创建压缩包时,一个看似微小却极易被忽略的语法错误——if __name__ == "__ main __": 中下划线间误加空格——会导致整个脚本无法作为主程序执行,从而让 make_archive() 函数根本不会被调用,表现为“代码不工作”但无报错提示。

该问题并非 zipfile 模块本身故障,而是入口判断逻辑失效:Python 要求严格匹配字符串 "__main__"(前后各两个连续下划线,中间无空格)。一旦写成 "__ main __",条件恒为 False,后续代码块被跳过,自然无法生成 ZIP 文件。

以下是修正后的完整、健壮的教程级实现:

import zipfile
import pathlib

def make_archive(filepaths, dest_dir):
    """将指定文件列表压缩为 ZIP 包,保存至目标目录"""
    dest_path = pathlib.Path(dest_dir) / "compressed.zip"

    # 确保目标目录存在
    dest_path.parent.mkdir(parents=True, exist_ok=True)

    with zipfile.ZipFile(dest_path, 'w', zipfile.ZIP_DEFLATED) as archive:
        for filepath in filepaths:
            path = pathlib.Path(filepath)
            if path.exists():
                # 使用相对路径归档,避免绝对路径污染 ZIP 结构
                archive.write(path, arcname=path.name)
                print(f"✓ 已添加: {path.name}")
            else:
                print(f"⚠ 警告: 文件不存在 — {filepath}")

# ✅ 正确的入口写法:双下划线紧邻,无空格
if __name__ == "__main__":
    make_archive(
        filepaths=["bonus 1.py", "bonus 2.py"],
        dest_dir="dest"
    )

关键注意事项:

dlt Python 数据加载工具
dlt Python 数据加载工具

一个开源的Python库,使从API、数据库和文件加载数据到结构化数据集变得简单且符合Python风格。dlt自动化模式推断、增量加载和数据规范化,支持DuckDB、BigQuery、Snowflake和Postgres等目标端。

下载
  • ? 入口名称必须精确为 "__main__":这是 Python 解释器识别主模块的硬性约定,任何空格、大小写或符号偏差均会导致失败;
  • ? 路径健壮性增强:添加 pathlib.Path(dest_dir) / "compressed.zip" 替代字符串拼接,更安全;
  • ? 存在性校验:检查待压缩文件是否存在,避免静默失败;
  • ? 压缩算法显式指定:使用 zipfile.ZIP_DEFLATED 确保通用兼容性(默认行为可能因 Python 版本而异);
  • ? 归档路径优化:通过 arcname=path.name 避免将完整绝对路径写入 ZIP,提升可移植性。

运行前请确保当前目录下存在 bonus 1.py 和 bonus 2.py 文件,且 dest 目录有写入权限。执行后将在 dest/compressed.zip 生成有效 ZIP 包,可通过解压工具或 zipfile.is_zipfile() 验证。

总结:此类问题本质是 Python 基础语法细节疏忽,而非库功能缺陷。养成严格对照官方文档书写特殊标识符的习惯(如 __init__, __str__, __main__),是规避低级错误、提升开发效率的关键一步。

Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1971

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

5604

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1909

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

34337

23

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

4007

5

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

4027

5

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1303

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

636

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

3123

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程