如何使用 Python 将多个子文件夹（不含父目录）打包为单个 ZIP 文件

如何使用 Python 将多个子文件夹（不含父目录）打包为单个 ZIP 文件

本文介绍如何用 Python 的 zipfile 模块精准压缩指定父目录下的所有子文件夹及其内容，跳过顶层父目录结构，实现解压后直接得到 Folder1、Folder2 等子文件夹，避免冗余嵌套。

在日常文件整理或项目分发时，我们常常遇到这样一个需求：想把一个父目录下的所有子文件夹打包成一个 ZIP 文件，并且希望解压后，直接就能看到“Folder1”、“Folder2”这些子文件夹，而不是先看到一个多余的父目录层。这个需求听起来简单，但用常规方法却容易踩坑。

如果你直接用 `shutil.make_archive` 去压缩整个父目录，得到的 ZIP 文件会完整保留原始路径。解压时，你会看到类似“Parent folder/Folder1/1.txt”的嵌套结构，多了一层完全不必要的父目录。那么，如何才能实现那种“解压即见子文件夹”的扁平化结构呢？

关键在于一个核心操作：在将每个文件写入 ZIP 时，只使用它相对于父目录的子路径作为压缩包内的路径。换句话说，就是要把“Parent folder/”这个前缀给精准地剔除掉。

下面这个方案健壮且可复用，能很好地解决这个问题：

import os
import glob
import zipfile

def compress_subfolders(parent_path, output_zip, include_parent_dir=False):
    """
    将 parent_path 下的所有直接子文件夹（及其全部内容）压缩为单个 ZIP 文件。
    :param parent_path: 父目录路径（如 'Parent folder'）
    :param output_zip: 输出 ZIP 文件路径（如 'archive.zip'）
    :param include_parent_dir: 若为 True，则保留父目录名作为 ZIP 根目录（不推荐）；默认 False（扁平化）
    """
    # 获取所有子文件夹下的非空文件（支持多级嵌套，但仅从子文件夹开始采集）
    files_to_compress = []
    for subfolder in os.listdir(parent_path):
        subpath = os.path.join(parent_path, subfolder)
        if os.path.isdir(subpath):
            # 递归收集该子文件夹下所有文件（含子子目录）
            for root, dirs, files in os.walk(subpath):
                for file in files:
                    files_to_compress.append(os.path.join(root, file))

    with zipfile.ZipFile(output_zip, 'w', zipfile.ZIP_DEFLATED) as zipf:
        for file_path in files_to_compress:
            if include_parent_dir:
                # 保留完整相对路径（含父目录名）
                arcname = os.path.relpath(file_path, os.path.dirname(parent_path))
            else:
                # 关键：移除 parent_path，使 Folder1/... 成为 ZIP 内顶层路径
                arcname = os.path.relpath(file_path, parent_path)
            zipf.write(file_path, arcname)

# 使用示例
if __name__ == "__main__":
    parent_folder = "Parent folder"   # 替换为你的实际父目录名
    output_zip = "combined_2024.zip"
    compress_subfolders(parent_folder, output_zip)
    print(f"✅ 已成功打包 {len(glob.glob(os.path.join(parent_folder, '*/*.*')))}+ 个文件到 {output_zip}")

核心要点说明

理解以下几个要点，你就能完全掌握这个方法的精髓：

• 路径转换是关键：函数中的 `os.path.relpath(file_path, parent_path)` 是实现“去父目录”的核心。它生成的压缩包内部路径是像“Folder1/1.txt”这样的，而不是“Parent folder/Folder1/1.txt”。
• 遍历方式更可靠：这里使用 `os.walk()` 来递归收集文件，而不是 `glob.glob(..., recursive=True)`。前者能更稳健地处理空子目录、隐藏文件以及不同操作系统下的路径分隔符问题。
• 压缩与归档：`zipfile.ZIP_DEFLATED` 参数启用了压缩，可以有效减小输出文件的体积。如果只是单纯归档而不需要压缩，可以省略这个参数。
• 工具选择：对于这个特定需求，不建议依赖 `shutil.make_archive`，因为它无法让我们自定义压缩包内部的路径映射关系，灵活性不足。

注意事项

在应用上述代码时，有几点需要留意：

立即学习“Python免费学习笔记（深入）”；

• 路径有效性：确保传入的 `parent_path` 是绝对路径，或者是相对于当前脚本工作目录的有效路径，避免因路径错误导致文件收集失败。
• 同名文件处理：如果不同的子文件夹中存在同名文件（比如 Folder1 和 Folder2 下都有一个 README.md），ZIP 文件会同时保留它们，不会发生冲突，因为它们的完整路径在包内是不同的。
• 文件过滤：如果需要排除特定类型的文件（例如临时文件 `.pyc` 或日志文件 `.log`），可以在 `os.walk()` 的循环内部添加一个过滤条件，比如 `if not file.endswith((‘.pyc‘, ‘.log‘)):`。

运行脚本后，生成的 ZIP 文件解压结果会完全符合预期：直接呈现出 Folder1、Folder2 等清晰的顶层子目录结构，真正做到开箱即用，没有一丝冗余。