Python 复制文件夹下所有文件及子文件夹

1. 引言

在使用计算机的过程中，我们经常需要对文件进行复制、移动、删除等操作。其中，复制文件夹及其下所有文件和子文件夹是一个非常常见的需求。Python 是一门功能强大的编程语言，在文件操作方面提供了丰富的库函数和方法，方便我们进行文件操作。本文将介绍如何使用 Python 复制文件夹及其下所有文件和子文件夹。

2. 复制文件夹的方法

Python 提供了 shutil 模块来处理复制文件和文件夹的操作。具体来说，shutil 模块中的 copytree() 函数可以实现复制文件夹及其下所有文件和子文件夹。

下面是 copytree() 函数的语法：

shutil.copytree(src, dst, symlinks=False, ignore=None, copy_function=copy2,
                ignore_dangling_symlinks=False)

• src：要复制的源文件夹路径。
• dst：目标文件夹路径。
• symlinks：复制过程中是否复制符号链接（默认为 False）。
• ignore：一个函数，接受要复制的文件夹中的每个项目的文件名列表作为参数，返回一个忽略的文件或文件夹的名称列表。
• copy_function：用于复制文件的函数，默认为 shutil.copy2()，可以使用自定义的复制函数。
• ignore_dangling_symlinks：是否忽略悬挂的符号链接（默认为 False）。

示例代码如下：

import shutil

# 定义源文件夹和目标文件夹路径
src_folder = "/path/to/source/folder"
dst_folder = "/path/to/destination/folder"

# 调用 copytree() 函数复制文件夹 
shutil.copytree(src_folder, dst_folder)

运行以上代码，将会复制源文件夹及其下所有文件和子文件夹到目标文件夹中。

3. 注意事项

在使用 copytree() 函数复制文件夹时，需要注意以下几点：

3.1 目标文件夹不能已存在

copytree() 函数要求目标文件夹必须不存在，否则会抛出 FileExistsError 异常。如果想要覆盖目标文件夹中的内容，可以先删除目标文件夹，然后再复制。

示例代码如下：

import shutil
import os

# 定义源文件夹和目标文件夹路径
src_folder = "/path/to/source/folder"
dst_folder = "/path/to/destination/folder"

# 如果目标文件夹已存在，先删除目标文件夹
if os.path.exists(dst_folder):
    shutil.rmtree(dst_folder)

# 调用 copytree() 函数复制文件夹 
shutil.copytree(src_folder, dst_folder)

3.2 权限限制

在复制文件夹时，如果目标文件夹的权限不足，将会抛出 PermissionError 异常。在这种情况下，我们需要确保目标文件夹有足够的写权限。

3.3 符号链接的处理

copytree() 函数默认情况下不会复制源文件夹中的符号链接。如果希望复制符号链接，可以将 symlinks 参数设置为 True。

示例代码如下：

import shutil

# 定义源文件夹和目标文件夹路径
src_folder = "/path/to/source/folder"
dst_folder = "/path/to/destination/folder"

# 调用 copytree() 函数复制文件夹，包括符号链接
shutil.copytree(src_folder, dst_folder, symlinks=True)

4. 总结

本文介绍了如何使用 Python 复制文件夹及其下所有文件和子文件夹。通过使用 shutil 模块的 copytree() 函数，我们可以轻松实现文件夹复制的操作。同时，我们还介绍了一些注意事项，包括目标文件夹不能已存在、权限限制和符号链接的处理等。