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

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

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

本文详细讲解如何利用 Python 的 zipfile 模块，精准压缩指定父目录下的所有子文件夹及其内部文件，并跳过顶层父目录结构。实现解压后直接呈现 Folder1、Folder2 等子文件夹，避免不必要的路径嵌套，提升文件分发与整理的效率。

在日常文件管理、项目备份或资料分发时，我们经常面临一个典型需求：需要将一个主文件夹下的所有子文件夹，连同其内部内容，打包成一个独立的 ZIP 压缩包。并且，我们希望解压这个 ZIP 文件后，能够直接看到“Folder1”、“Folder2”等子文件夹，而不是先看到一个多余的父目录层。这个需求看似基础，但使用常规的压缩工具或方法往往无法直接实现。

如果直接使用 Python 的 `shutil.make_archive` 函数压缩整个父目录，生成的 ZIP 文件会完整保留原始目录层级。解压时，你会得到类似“Parent folder/Folder1/1.txt”的嵌套结构，这层父目录通常是冗余的。那么，如何实现“解压即见子文件夹”的扁平化打包效果呢？

实现这一目标的核心在于路径处理：在将每个文件写入 ZIP 压缩包时，仅使用该文件相对于指定父目录的相对路径作为其在压缩包内的存储路径。这意味着，我们需要在代码逻辑中精准地剔除“Parent folder/”这个前缀。

以下提供一个健壮、可复用的 Python 解决方案，能完美解决上述问题：

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` 参数启用了标准的 DEFLATE 压缩算法，能有效减小输出文件体积。若仅需归档而不压缩，可改用 `zipfile.ZIP_STORED`。
• 工具选择建议：针对这种需要自定义内部路径映射的特定需求，不推荐使用 `shutil.make_archive`，因为其灵活性不足，无法精细控制压缩包内的目录结构。

实践注意事项

在实际应用上述 Python 脚本时，请注意以下几点：

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

• 确保路径有效：传入的 `parent_path` 参数建议使用绝对路径，或确保它是相对于当前 Python 脚本工作目录的正确相对路径，以避免因路径错误导致文件收集失败。
• 同名文件处理机制：如果不同的子文件夹中存在同名文件（例如，Folder1 和 Folder2 下都有一个“config.ini”），ZIP 文件格式允许同时保存它们，因为它们在压缩包内的完整路径（如“Folder1/config.ini”和“Folder2/config.ini”）是不同的，不会引发冲突。
• 灵活进行文件过滤：若需排除特定类型的文件（如 Python 字节码文件 `.pyc` 或日志文件 `.log`），可以在 `os.walk()` 循环内部添加过滤条件，例如：`if not file.endswith((‘.pyc‘, ‘.log‘)):`。

运行此脚本后，生成的 ZIP 文件解压结果将完全符合预期：直接呈现出 Folder1、Folder2 等清晰的顶层子目录结构，真正做到开箱即用，无需手动调整，极大提升了文件整理的效率。