如何用python脚本复制文件夹

使用Python脚本复制文件夹的方法有多种，主要包括使用shutil模块、os模块、以及使用第三方库等。本文将详细介绍这些方法并提供示例代码。

一、使用shutil模块

Python的shutil模块提供了许多文件操作功能，包括复制文件夹。shutil.copytree()函数可以递归地复制整个文件夹，包括其内容。这是最常用且最简单的方法。

shutil模块的优点：

易于使用：shutil.copytree()方法非常直接。
功能丰富：shutil模块不仅可以复制文件夹，还可以移动、删除文件和文件夹。
内置模块：shutil是Python的标准库，无需安装额外的依赖。

import shutil
import os
def copy_directory(src, dst):
    try:
        # 确保目标目录存在
        if not os.path.exists(dst):
            os.makedirs(dst)
        # 复制文件夹及其内容
        shutil.copytree(src, dst)
        print(f"文件夹 '{src}' 已成功复制到 '{dst}'")
    except Exception as e:
        print(f"复制过程中出现错误: {e}")
示例用法
source_dir = 'path/to/source/folder'
destination_dir = 'path/to/destination/folder'
copy_directory(source_dir, destination_dir)

shutil.copytree()的参数：

src：源文件夹路径。
dst：目标文件夹路径。

二、使用os模块手动复制文件夹

os模块是Python的标准库之一，提供了与操作系统进行交互的功能。虽然os模块没有直接复制文件夹的函数，但可以通过遍历源文件夹的内容并逐个复制文件和文件夹来实现。

os模块的优点：

灵活性高：可以自定义复制过程，例如过滤特定文件。
细粒度控制：可以精确控制每个文件和文件夹的复制方式。

import os
import shutil
def copy_directory_manual(src, dst):
    try:
        # 确保目标目录存在
        if not os.path.exists(dst):
            os.makedirs(dst)
        # 遍历源目录
        for item in os.listdir(src):
            s = os.path.join(src, item)
            d = os.path.join(dst, item)
            if os.path.isdir(s):
                # 递归复制子目录
                copy_directory_manual(s, d)
            else:
                # 复制文件
                shutil.copy2(s, d)
        print(f"文件夹 '{src}' 已成功复制到 '{dst}'")
    except Exception as e:
        print(f"复制过程中出现错误: {e}")
示例用法
source_dir = 'path/to/source/folder'
destination_dir = 'path/to/destination/folder'
copy_directory_manual(source_dir, destination_dir)

手动复制的步骤：

创建目标文件夹：如果目标文件夹不存在，则创建它。
遍历源文件夹：使用os.listdir()函数获取源文件夹中的所有文件和子文件夹。
递归复制：对于每个文件夹，递归调用函数本身；对于每个文件，使用shutil.copy2()复制到目标文件夹。

三、使用第三方库

有时，使用第三方库可以简化代码并提供额外的功能。例如，distutils.dir_util模块提供了copy_tree()函数，可以递归复制文件夹。

第三方库的优点：

简化代码：通常比手动实现更简洁。
额外功能：一些库提供了额外的功能，例如压缩、解压缩等。

from distutils.dir_util import copy_tree
def copy_directory_distutils(src, dst):
    try:
        copy_tree(src, dst)
        print(f"文件夹 '{src}' 已成功复制到 '{dst}'")
    except Exception as e:
        print(f"复制过程中出现错误: {e}")
示例用法
source_dir = 'path/to/source/folder'
destination_dir = 'path/to/destination/folder'
copy_directory_distutils(source_dir, destination_dir)

copy_tree()函数的参数：

src：源文件夹路径。
dst：目标文件夹路径。

四、注意事项

权限问题：确保有足够的权限读取源文件夹和写入目标文件夹。
文件名冲突：处理文件名冲突时，可以选择覆盖、重命名或跳过。
大文件夹：对于包含大量文件或子文件夹的文件夹，建议使用异步I/O或多线程提高效率。

五、综合示例

下面是一个综合示例，结合了前述方法中的优点，并处理了常见的错误情况。

import os
import shutil
from distutils.dir_util import copy_tree
def copy_directory(src, dst, method='shutil'):
    try:
        # 确保目标目录存在
        if not os.path.exists(dst):
            os.makedirs(dst)
        if method == 'shutil':
            shutil.copytree(src, dst)
        elif method == 'os':
            for item in os.listdir(src):
                s = os.path.join(src, item)
                d = os.path.join(dst, item)
                if os.path.isdir(s):
                    copy_directory(s, d, method)
                else:
                    shutil.copy2(s, d)
        elif method == 'distutils':
            copy_tree(src, dst)
        else:
            raise ValueError("不支持的方法: " + method)
        print(f"文件夹 '{src}' 已成功复制到 '{dst}' 使用方法: {method}")
    except Exception as e:
        print(f"复制过程中出现错误: {e}")
示例用法
source_dir = 'path/to/source/folder'
destination_dir = 'path/to/destination/folder'
copy_method = 'shutil'  # 可选 'shutil', 'os', 'distutils'
copy_directory(source_dir, destination_dir, copy_method)

总结：

通过本文，您学习了如何使用Python脚本复制文件夹的方法，包括shutil模块、os模块和第三方库。shutil模块是最简单和最常用的方法，适合大多数场景。os模块提供了更高的灵活性和控制，适用于需要自定义复制过程的情况。第三方库如distutils.dir_util简化了代码并提供了额外功能。在实际应用中，可以根据具体需求选择合适的方法。