python3 如何复制文件夹

Python3 复制文件夹的方法有很多，比如使用shutil模块、os模块、distutils.dir_util模块等。其中，最常用的方法是使用shutil模块，因为它不仅简单易用，而且功能非常强大。下面将详细介绍shutil模块，并演示如何使用它来复制文件夹。

一、使用shutil模块复制文件夹

shutil模块是Python标准库中的一个模块，提供了一些高级的文件操作功能，比如复制、移动、删除文件和文件夹等。要复制文件夹，可以使用shutil.copytree()函数。这个函数会递归地复制源文件夹及其所有内容到目标文件夹。

import shutil
def copy_directory(src, dst):
    """
    复制文件夹及其所有内容
    :param src: 源文件夹路径
    :param dst: 目标文件夹路径
    """
    try:
        shutil.copytree(src, dst)
        print(f"文件夹复制成功：{src} -> {dst}")
    except Exception as e:
        print(f"复制文件夹时出错：{e}")
示例
src_directory = 'path/to/source/folder'
dst_directory = 'path/to/destination/folder'
copy_directory(src_directory, dst_directory)

shutil.copytree()函数的核心参数包括：源文件夹路径、目标文件夹路径。它会递归地复制源文件夹中的所有文件和子文件夹到目标文件夹中。如果目标文件夹已经存在，这个函数会引发FileExistsError异常。因此，在调用shutil.copytree()之前，可以先检查目标文件夹是否存在，并删除它。

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

虽然shutil模块是复制文件夹的首选方法，但有时也可以使用os模块来实现相同的功能。os模块提供了一些基本的文件和目录操作函数，比如os.mkdir()、os.listdir()、os.path.isfile()等。下面是使用os模块递归复制文件夹的示例代码：

import os
import shutil
def copy_directory(src, dst):
    """
    使用os模块递归复制文件夹及其所有内容
    :param src: 源文件夹路径
    :param dst: 目标文件夹路径
    """
    try:
        if not os.path.exists(dst):
            os.makedirs(dst)
        for item in os.listdir(src):
            src_item = os.path.join(src, item)
            dst_item = os.path.join(dst, item)
            if os.path.isdir(src_item):
                copy_directory(src_item, dst_item)
            else:
                shutil.copy2(src_item, dst_item)
        print(f"文件夹复制成功：{src} -> {dst}")
    except Exception as e:
        print(f"复制文件夹时出错：{e}")
示例
src_directory = 'path/to/source/folder'
dst_directory = 'path/to/destination/folder'
copy_directory(src_directory, dst_directory)

在这个示例中，我们使用os.makedirs()函数创建目标文件夹，然后递归地遍历源文件夹中的所有文件和子文件夹，并使用shutil.copy2()函数复制文件。shutil.copy2()函数会保留文件的元数据，比如创建时间和修改时间。

三、使用distutils.dir_util模块复制文件夹

distutils.dir_util模块也是Python标准库中的一个模块，提供了一些与目录操作相关的实用函数。要复制文件夹，可以使用distutils.dir_util.copy_tree()函数。这个函数会递归地复制源文件夹及其所有内容到目标文件夹。

from distutils.dir_util import copy_tree
def copy_directory(src, dst):
    """
    使用distutils.dir_util模块复制文件夹及其所有内容
    :param src: 源文件夹路径
    :param dst: 目标文件夹路径
    """
    try:
        copy_tree(src, dst)
        print(f"文件夹复制成功：{src} -> {dst}")
    except Exception as e:
        print(f"复制文件夹时出错：{e}")
示例
src_directory = 'path/to/source/folder'
dst_directory = 'path/to/destination/folder'
copy_directory(src_directory, dst_directory)

distutils.dir_util.copy_tree()函数的核心参数包括：源文件夹路径、目标文件夹路径。它会递归地复制源文件夹中的所有文件和子文件夹到目标文件夹中。如果目标文件夹已经存在，这个函数不会引发异常，而是会覆盖目标文件夹中的文件和子文件夹。

四、使用第三方库复制文件夹

除了上述方法，还可以使用一些第三方库来复制文件夹，比如pathlib、send2trash等。pathlib是Python标准库中的一个模块，提供了面向对象的文件和目录操作接口。send2trash是一个第三方库，可以安全地删除文件和文件夹。

使用pathlib模块复制文件夹

pathlib模块提供了一些方便的文件和目录操作方法，比如Path.mkdir()、Path.iterdir()等。要复制文件夹，可以使用pathlib模块递归地遍历源文件夹，并创建目标文件夹和文件。

from pathlib import Path
import shutil
def copy_directory(src, dst):
    """
    使用pathlib模块递归复制文件夹及其所有内容
    :param src: 源文件夹路径
    :param dst: 目标文件夹路径
    """
    try:
        src_path = Path(src)
        dst_path = Path(dst)
        if not dst_path.exists():
            dst_path.mkdir(parents=True)
        for item in src_path.iterdir():
            src_item = src_path / item
            dst_item = dst_path / item
            if src_item.is_dir():
                copy_directory(src_item, dst_item)
            else:
                shutil.copy2(src_item, dst_item)
        print(f"文件夹复制成功：{src} -> {dst}")
    except Exception as e:
        print(f"复制文件夹时出错：{e}")
示例
src_directory = 'path/to/source/folder'
dst_directory = 'path/to/destination/folder'
copy_directory(src_directory, dst_directory)

在这个示例中，我们使用Path.mkdir()方法创建目标文件夹，然后递归地遍历源文件夹中的所有文件和子文件夹，并使用shutil.copy2()函数复制文件。

使用send2trash库安全删除文件夹

send2trash库提供了一种将文件和文件夹移到回收站的方法，而不是直接删除它们。这样可以防止误删除重要文件。要使用send2trash库，可以先安装它：

pip install send2trash

然后使用send2trash.send2trash()函数删除文件夹：

from send2trash import send2trash
def delete_directory(dir_path):
    """
    使用send2trash库安全删除文件夹
    :param dir_path: 要删除的文件夹路径
    """
    try:
        send2trash(dir_path)
        print(f"文件夹已移到回收站：{dir_path}")
    except Exception as e:
        print(f"删除文件夹时出错：{e}")
示例
dir_path = 'path/to/folder'
delete_directory(dir_path)

send2trash.send2trash()函数的核心参数是要删除的文件夹路径。它会将文件夹移到回收站，而不是直接删除，从而提供了一种更安全的删除方式。

总结

在Python3中，复制文件夹的方法有很多，比如使用shutil模块、os模块、distutils.dir_util模块、pathlib模块等。shutil模块是最常用的方法，因为它简单易用且功能强大。os模块和pathlib模块也可以用于复制文件夹，但需要手动递归遍历文件和子文件夹。distutils.dir_util模块提供了类似于shutil模块的功能，但使用较少。send2trash库提供了一种安全删除文件和文件夹的方法，将它们移到回收站而不是直接删除。

在实际应用中，可以根据具体需求选择合适的方法来复制文件夹。如果需要简单、快速地复制文件夹，shutil模块是首选。如果需要更灵活的文件操作，可以考虑使用os模块或pathlib模块。如果需要安全删除文件夹，send2trash库是一个不错的选择。